Billit Data model for KSeF

Basic Header Information

Header Information

Description	Billit API Field	KSeF Field	Max. Length
Invoice number	OrderNumber	Fa/P_2	50
Purchase Order	Reference	WarunkiTransakcji / Zamowienia / NrZamowieni	50
Currency	Currency	Fa / KodWaluty
Due date	OrderDate	Platnosc / TerminPlatnosci / Termin
Free description (footer text)	Comments	Stopka / Informacje / StopkaFaktury	2048
Foreign Currency Conversion (no PL)	FXRateToForeign	see separate information page
Tax code	VentilationCode	see separate information page

Customer

Description	Billit API Field	KSeF Field
Name Company	Name	Podmiot2 / DaneIdentyfikacyjne / Nazwa
VAT Number (When customer has VAT number)	VATNumber	Podmiot2 / DaneIdentyfikacyjne / NIP
Invoice Address : Street	Street	Podmiot2 / Adres / AdresL1
Invoice Address : Street number	StreetNumber	Podmiot2 / Adres / AdresL1
Invoice Address : ZIP	Zipcode	Podmiot2 / Adres / AdresL2
Invoice Address : City	City	Podmiot2 / Adres / AdresL2
Invoice Address : Country	CountryCode	Podmiot2 / Adres / KodKraju
Email	Email	Podmiot2 /DaneKontaktowe / Email
Phone	Phone	Podmiot2 / DaneKontaktowe / Telefon

Example Json:

"Customer": {
        "Name": "CUSTOMER POLSKA",
        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "CUSTOMER POLSKA",
                "Street": "INŻYNIERSKA",
                "StreetNumber": "99",
                "Zipcode": "96-599",
                "City": "SOCHACZEW",
                "CountryCode": "PL"
            },
        ],
  	    "VATNumber": "PL9570864999",       
        "Email": "[email protected]",
        "Phone" : "+48468631999",  // Customer Phone
        "PartyType": "Customer",
        "VATLiable": true,
        "Language": "EN",
        "VATDeductable": true
},

Supplier

Method:

By Default the data stored in My Company are used to include supplier data in the KSeF message
When the data-elements below are included in the API Json file, then they will have priority and be included in the KSeF XML.

Field specifications:

Description	Billit API Field	KSeF Field
Contact Phone Supplier	Custom Field : Faktura.Podmiot1.DaneKontaktowe.Telefon	DaneKontaktowe / Telefon
Contact Email Supplier	Custom Field : Faktura.Podmiot1.DaneKontaktowe.Email	DaneKontaktowe / Email

Examples below with only this specific additional information:

    "CustomFields":  
			{
               "Faktura.Podmiot1.DaneKontaktowe.Telefon" : "+48618189999",
               "Faktura.Podmiot1.DaneKontaktowe.Email" : "[email protected]"
      },

Special Scenario's:

Description	Solution
Customer has no VAT number but has a NIP number	Include NIP number in Billit identifiers segment

Other remarks:

Totals are generated by Billit

Extra Optional Party / Location Based on Podmiot3

Pofdmiot3 can be used for several purposes, possible use:

Tax representative (main) : Foreign company represented in Poland by a tax proxy. Invoice issuer on behalf of seller.
Payment-related third party.
Factoring company (in some setups).
Delivery / contract-related party.

Limitations:

Used on Header Level.

Data model For Podmiot 3 (all 6 fields must be present !)

Billit Field	Description	Mandatory ?
"Faktura.Podmiot3.DaneIdentyfikacyjne.NIP	Tax Identification Number of the third party (without PL)	Yes
"Faktura.Podmiot3.DaneIdentyfikacyjne.Nazwa	Name of the company	Yes
Faktura.Podmiot3.Adres.KodKraju	Country Code	Yes
Faktura.Podmiot3.Adres.AdresL1	Adress / street first line	Yes
Faktura.Podmiot3.Adres.AdresL2	Adress / street second line	Yes
"Faktura.Podmiot3.Rola	Role according to a table	Yes

Example:

"CustomFields": {
        "Faktura.Podmiot3.DaneIdentyfikacyjne.NIP" : "5250011266", // CompanyIdentifier without PL
        "Faktura.Podmiot3.DaneIdentyfikacyjne.Nazwa" : "CompanyName", // CompanyName
        "Faktura.Podmiot3.Adres.KodKraju" : "PL", // Country
        "Faktura.Podmiot3.Adres.AdresL1" : "Teststreet 12", // Street StreetNumber
        "Faktura.Podmiot3.Adres.AdresL2" : "62-020 Swarzędz", // Zipcode City
        "Faktura.Podmiot3.Rola" : "2" // Role 
			},

Roles:

Role number	Role Description
1	Factor (Factoring),
2	Recepient (internal units, branches, divisions),
3	Original Entity (when the invoice includes the details of an entity that was taken over or transformed and originally supplied the goods or services),
4	Additional purchaser when the invoice includes details of further purchasers (other than the one indicated in section of Podmiot2),
5	Invoice issuer when the invoice includes details of the entity issuing the invoice on behalf of the taxpayer,
6	Payer when the invoice includes details of the entity making the payment on behalf of the purchaser,
7	Local government unit (LGU) issuer,
8	Local government unit (LGU) recipient,
9	GV member issuer,
10	GV member recipient,
11	Employee.

Detaillines - Basic Information

Description Line	Billit API Field	KSeF Field	Max Length
Quantity	Quantity	FaWiersz / P_8B
Unit Price Excluding VAT	UnitPriceExcl	FaWiersz / P_9A
Description	Description	FaWiersz / P_7	256
VAT Percentage	VATPercentage	FaWiersz / P_12

Remarks:

Linetotals are generated by Billit
"DescriptionExtended" will not be mapped

Detaillines - Advanced References

On Line level, 4 additional descriptions can be added:

Description	Billit API Line Custom Field	KSeF Line Field	Max Length
GTIN (Standardised Article Number, EAN)	FaWiersz.GTIN	GTINE
Code For Goods or Services : Internal by taxpayer or additional description of choice	FaWiersz.Indeks	Indeks	50
PKWIU (number in the Polish Classification of Goods and Services)	FaWiersz.PKWiU	PKWiU
Combined Nomenclature symbol	FaWiersz.CN	CN

Example:

"OrderLines": [
		{
			"Quantity": 6.5,
			"UnitPriceExcl": 6.24,
			"Description": "Product Description 1",
			"CustomFields": 
            {
                "FaWiersz.GTIN": "4025515080756",
                "FaWiersz.Indeks": "6ES7135-6HD00-0BA1",
                "FaWiersz.PKWiU": "27.12.40.0",
                "FaWiersz.CN": "85389091"
            },
            "VATPercentage": 23.0
		},
		{
			"Quantity": 78.0,
			"UnitPriceExcl": 10.75,
			"Description": "Product Description 2",
			"CustomFields": {},
      "VATPercentage": 23.0
		},
			],