Langkau ke kandungan
Kembali ke blog
FormatDiterbitkan 9 Julai 20266 minit bacaan

Satu API penukar format invois: apa-apa format masuk, e-invois patuh keluar

Setiap negara mahu format e-invois yang berbeza, tetapi ERP anda masih mengeksport CSV yang sama. Inilah cara satu API penukar format invois menyelesaikannya.

Anda membina eksport ERP anda sekali sahaja. Ia mengeluarkan CSV, atau mungkin fail UBL, dan selama bertahun-tahun itu memadai. Kemudian Perancis mewajibkan Factur-X. Jerman mahu XRechnung. Itali ada FatturaPA dan pelepasan SdI-nya. Poland sedang melancarkan KSeF dengan skema FA(3). Sepanyol menjangkakan Facturae. Norway berjalan atas EHF melalui Peppol. UAE, Oman dan Singapura sedang menyeragamkan kepada PINT.

ERP anda tidak berubah. Dunia di sekelilingnya yang berubah. Dan kini setiap pelanggan atau negara baharu yang disentuh perniagaan anda datang dengan tuntutan teknikal berbeza, sementara pasukan kewangan anda terperangkap mengeksport fail yang sama seperti biasa.

Mengapa format invois berpecah sejak awal

Terdapat satu standard Eropah, EN 16931, yang mentakrifkan model semantik sepunya untuk invois elektronik. Secara teori, semua orang bersetuju tentang maksud «jumlah bersih» atau «pengecam VAT pembeli». Secara praktik, setiap negara membalut model itu dengan sintaksnya sendiri, medan wajibnya sendiri dan peraturan pengesahannya sendiri.

XRechnung dan Factur-X kedua-duanya berasaskan EN 16931, tetapi ia bukan fail yang boleh ditukar ganti. FatturaPA wujud sebelum standard itu dan menggunakan skema Itali tersendiri sepenuhnya. KSeF FA(3) khusus untuk Poland. Jadi «kami menyokong e-invois» tidak pernah menjadi satu kerja. Ia belasan kerja yang semuanya bermula daripada data sumber yang sama dan berakhir dalam fail yang tidak serasi. Itulah jurang yang API penukar format invois dibina untuk menutupnya: anda terus mengeksport apa yang anda sudah eksport, dan sesuatu yang lain menguruskan penterjemahan kepada apa yang dituntut setiap destinasi.

Apa sebenarnya maksud «apa-apa format masuk»

Bahagian yang menyusahkan biasanya input, bukan output. Sistem perakaunan sebenar mengeksport data lama dan tidak konsisten: CSV rata dengan 40 lajur, helaian Excel yang diselenggara seorang pengawal secara manual, EDIFACT daripada persediaan EDI lama, atau UBL dan CII berstruktur daripada tindanan yang lebih baharu. Sesetengahnya menghantar PDF ZUGFeRD atau Factur-X dengan XML terbenam di dalamnya.

API penukaran yang berbaloi digunakan membaca semua itu. MyInvoice menerima CSV, Excel, EDIFACT, UBL, CII dan PDF ZUGFeRD/Factur-X sebagai input — dan apabila pembekal menghantar anda PDF hibrid, ia mengeluarkan XML daripada fail itu dan menormalkannya kepada model bersih yang sama. Bahagian terakhir itu lebih penting daripada bunyinya: e-invois yang anda terima menjadi input yang sah, bukan sekadar sesuatu untuk difailkan. Anda boleh mengambil dokumen Factur-X atau ZUGFeRD masuk dan mengeluarkannya semula sebagai Peppol BIS atau XRechnung tanpa membina semula saluran paip anda.

Satu API, setiap output yang patuh

Sebaik data anda dihuraikan ke dalam model sepunya, output ialah satu pilihan, bukan pembinaan semula. Invois sumber yang sama boleh keluar sebagai:

  • Peppol BIS 3.0 untuk rangkaian Peppol
  • XRechnung untuk pembeli sektor awam Jerman
  • Factur-X / ZUGFeRD untuk Perancis dan Jerman
  • FatturaPA untuk Itali
  • KSeF FA(3) untuk Poland
  • EHF untuk Norway
  • PINT untuk UAE, Oman dan Singapura

Anda menghantar data sekali dan memilih format pada penghujungnya. Apabila sebuah negara baharu mula beroperasi, anda menukar satu parameter, bukan ERP anda.

Kekalkan sistem anda, betulkan batu terakhir

Tujuannya bukan menggantikan perisian anda. Ia untuk berhenti memasang projek format sekali guna setiap kali satu mandat tiba. ERP anda terus mengeksport CSV-nya. API menguruskan batu terakhir, menukar eksport itu kepada fail tepat yang akan diterima sesebuah negara atau rangkaian Peppol, dan mengesahkan hasilnya sebelum anda menghantarnya.

Jika pasukan anda berdepan mandat baharu dengan fail eksport lama yang sama, itulah jurang yang ditutupnya. Lihat MyInvoice dan cuba tukar salah satu eksport sebenar anda kepada format yang anda benar-benar perlukan.

Tukar salah satu eksport anda dalam pelayarBaca dokumentasi API