Przykłady faktury (Document + profil FK oraz model kanoniczny Invoice)
Przykłady faktury zgodne z mapowaniem Document → faktura / KSeF (weryfikacja zgodności) oraz modelem kanonicznym Invoice i InvoicePosition. Snapshot profilu kanonicznego (kardynalności, ValueSet): Profile kanoniczne. Prezentowane są dwie reprezentacje:
- Document + profil FK — faktura jako zasób Document z
type=invoice, pozycjami wg profilu (invoice-line, vat-summary-line) i atrybutami podsumowania; uczestnicy jako referencje do PartyRole, dane stron w Party. - Model kanoniczny Invoice — dedykowany zasób Invoice z zagnieżdżonymi pozycjami InvoicePosition (seller, buyer, totalNet, totalVat, totalGross, position[]).
W obu przypadkach stosowane są identyfikatory z Identifier.system (np. numer firmy, KSeF), stawki VAT z systemu vat-rate, kwoty w Money (value + currency).
1. Faktura jako Document (profil FK)
Faktura wystawiona przez sprzedawcę na nabywcę: dwie pozycje towarowe (VAT 23%), jedna pozycja z akcyzą (VAT + kwota akcyzy), linia podsumowania VAT oraz atrybuty sum na poziomie dokumentu. Uczestnicy: participant = referencje do PartyRole (role=seller, role=buyer); dane stron w contained (Party, PartyRole), aby przykład był samodzielny.
Pola profilu FK (saleDate, dueDate, paymentMethod, paymentAccount, splitPayment) przekazujemy przez attribute i/lub dedykowane pola profilu.
{
"resourceType": "Document",
"id": "doc-invoice-fk-001",
"meta": { "lastModified": "2025-02-20T12:00:00Z" },
"identifier": [
{ "system": "https://api-erp.kamsoft.pl/ns/company", "value": "FV/2025/0567" },
{ "system": "https://ksef.mf.gov.pl/", "value": "KSeF-12345678-20250220-ABC123" }
],
"type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-type", "code": "invoice", "display": "Faktura" }] },
"status": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-status", "code": "issued", "display": "Wystawiona" }] },
"issueDate": "2025-02-20",
"attribute": [
{ "url": "https://api-erp.kamsoft.pl/ns/fk/saleDate", "valueDate": "2025-02-20" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/dueDate", "valueDate": "2025-03-06" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/paymentMethod", "valueCodeableConcept": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/payment-method", "code": "transfer", "display": "Przelew" }] } },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/paymentAccount", "valueReference": { "reference": "BankAccount/ba-seller-01", "display": "12 3456 7890 1234 5678 9012 3456" } },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/splitPayment", "valueBoolean": false },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/ksefAcquisitionDate", "valueDateTime": "2025-02-20T11:45:00Z" }
],
"participant": [
{ "reference": "#partyRole-seller", "display": "Sprzedawca Sp. z o.o." },
{ "reference": "#partyRole-buyer", "display": "Kupujący ABC Sp. z o.o." }
],
"position": [
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line", "display": "Wiersz faktury" }] },
"positionNo": 1,
"valueString": "Usługa konsultingowa – miesiąc luty 2025",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 1, "unit": "szt" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "unit-price" }] }, "valueMoney": { "value": 5000, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 5000, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 1150, "currency": "PLN" } }
],
"valueCodeableConcept": [
{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] }
],
"valueReference": [{ "reference": "ProductDefinition/svc-consult-01", "display": "Konsulting" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line", "display": "Wiersz faktury" }] },
"positionNo": 2,
"valueString": "Wyroby akcyzowe – przykładowa kategoria",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 10, "unit": "szt" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "unit-price" }] }, "valueMoney": { "value": 100, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 1000, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 230, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "excise-amount" }] }, "valueMoney": { "value": 50, "currency": "PLN" } }
],
"valueCodeableConcept": [
{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] },
{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/excise-type", "code": "alcohol", "display": "Alkohol" }] }
],
"valueReference": [{ "reference": "Product/excise-01", "display": "Wyrok akcyzowy" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "vat-summary-line", "display": "Podsumowanie VAT" }] },
"positionNo": 3,
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 6000, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 1380, "currency": "PLN" } }
],
"valueCodeableConcept": [
{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] }
]
}
],
"attribute": [
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-net" }] }, "valueMoney": { "value": 6000, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-vat" }] }, "valueMoney": { "value": 1380, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-excise" }] }, "valueMoney": { "value": 50, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-gross" }] }, "valueMoney": { "value": 7430, "currency": "PLN" } }
],
"contained": [
{
"resourceType": "Party",
"id": "party-seller",
"identifier": [{ "system": "urn:pl:nip", "value": "1234567890" }],
"name": "Sprzedawca Sp. z o.o.",
"address": [{ "use": "work", "line": ["ul. Przykładowa 1"], "city": "Warszawa", "postalCode": "00-001", "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-seller",
"party": { "reference": "#party-seller" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "seller", "display": "Wystawca" }] }
},
{
"resourceType": "Party",
"id": "party-buyer",
"identifier": [{ "system": "urn:pl:nip", "value": "9876543210" }],
"name": "Kupujący ABC Sp. z o.o.",
"address": [{ "use": "work", "line": ["ul. Odbiorcza 2"], "city": "Kraków", "postalCode": "30-001", "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-buyer",
"party": { "reference": "#party-buyer" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "buyer", "display": "Nabywca" }] }
}
]
}
Uwagi:
- participant wskazuje na zasoby w contained (
#partyRole-seller,#partyRole-buyer); w PartyRole pole party wskazuje na Party (wystawca/nabywca) z NIP i adresem. - Numer KSeF jest w identifier z
system: "https://ksef.mf.gov.pl/"ivalue= numer nadany przez KSeF. - Wiersz 2 zawiera excise-amount (valueItem) oraz excise-type (valueCodeableConcept); na poziomie dokumentu total-excise jest w attribute.
- Sumy: total-net 6000, total-vat 1380, total-excise 50, total-gross 7430 PLN.
2. Faktura w modelu kanonicznym (Invoice + InvoicePosition)
Ten sam przypadek biznesowy w postaci zasobu Invoice z zagnieżdżonymi position[] (InvoicePosition). Pola nagłówka: seller, buyer, totalNet, totalVat, totalExcise, totalGross, currency, terminy i płatność. Pozycje z jawnymi polami: positionNo, description, quantity, unitPriceNet, netAmount, vatRate, vatAmount; w pozycji 2 dodatkowo exciseAmount i exciseType.
{
"resourceType": "Invoice",
"id": "inv-2025-0567",
"meta": { "lastModified": "2025-02-20T12:00:00Z" },
"identifier": [
{ "system": "https://api-erp.kamsoft.pl/ns/company", "value": "FV/2025/0567" },
{ "system": "https://ksef.mf.gov.pl/", "value": "KSeF-12345678-20250220-ABC123" }
],
"type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-type", "code": "invoice", "display": "Faktura" }] },
"status": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-status", "code": "issued", "display": "Wystawiona" }] },
"issueDate": "2025-02-20",
"saleDate": "2025-02-20",
"dueDate": "2025-03-06",
"seller": { "reference": "#partyRole-seller", "display": "Sprzedawca Sp. z o.o." },
"buyer": { "reference": "#partyRole-buyer", "display": "Kupujący ABC Sp. z o.o." },
"totalNet": { "value": 6000, "currency": "PLN" },
"totalVat": { "value": 1380, "currency": "PLN" },
"totalExcise": { "value": 50, "currency": "PLN" },
"totalGross": { "value": 7430, "currency": "PLN" },
"currency": "PLN",
"paymentMethod": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/payment-method", "code": "transfer", "display": "Przelew" }] },
"paymentAccount": { "reference": "BankAccount/ba-seller-01", "display": "12 3456 7890 1234 5678 9012 3456" },
"splitPayment": false,
"ksefAcquisitionDate": "2025-02-20T11:45:00Z",
"position": [
{
"positionNo": 1,
"description": "Usługa konsultingowa – miesiąc luty 2025",
"quantity": { "value": 1, "unit": "szt" },
"unitPriceNet": { "value": 5000, "currency": "PLN" },
"netAmount": { "value": 5000, "currency": "PLN" },
"vatRate": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] },
"vatAmount": { "value": 1150, "currency": "PLN" },
"productReference": { "reference": "ProductDefinition/svc-consult-01", "display": "Konsulting" }
},
{
"positionNo": 2,
"description": "Wyroby akcyzowe – przykładowa kategoria",
"quantity": { "value": 10, "unit": "szt" },
"unitPriceNet": { "value": 100, "currency": "PLN" },
"netAmount": { "value": 1000, "currency": "PLN" },
"vatRate": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] },
"vatAmount": { "value": 230, "currency": "PLN" },
"exciseAmount": { "value": 50, "currency": "PLN" },
"exciseType": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/excise-type", "code": "alcohol", "display": "Alkohol" }] },
"productReference": { "reference": "Product/excise-01", "display": "Wyrok akcyzowy" }
}
],
"contained": [
{
"resourceType": "Party",
"id": "party-seller",
"identifier": [{ "system": "urn:pl:nip", "value": "1234567890" }],
"name": "Sprzedawca Sp. z o.o.",
"address": [{ "use": "work", "line": ["ul. Przykładowa 1"], "city": "Warszawa", "postalCode": "00-001", "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-seller",
"party": { "reference": "#party-seller" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "seller", "display": "Wystawca" }] }
},
{
"resourceType": "Party",
"id": "party-buyer",
"identifier": [{ "system": "urn:pl:nip", "value": "9876543210" }],
"name": "Kupujący ABC Sp. z o.o.",
"address": [{ "use": "work", "line": ["ul. Odbiorcza 2"], "city": "Kraków", "postalCode": "30-001", "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-buyer",
"party": { "reference": "#party-buyer" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "buyer", "display": "Nabywca" }] }
}
]
}
Uwagi:
- seller i buyer to referencje do PartyRole (w przykładzie w contained); dane firm w Party.
- totalExcise na nagłówku odpowiada sumie kwot akcyzy z pozycji; totalGross = totalNet + totalVat + totalExcise (w tym przykładzie 6000 + 1380 + 50 = 7430).
- Pozycja 2 zawiera exciseAmount i exciseType zgodnie z modelem kanonicznym.
3. Przykład: faktura KSeF (XML) dopasowana do Document i Invoice
Poniżej faktura z pliku KSeF (FA(3)) — 7671004218-20260222-644401C00054-A6.xml — zmapowana na model Document (profil FK) oraz na model kanoniczny Invoice. Źródło: struktura FA z http://crd.gov.pl/wzor/2025/06/25/13775/.
3.1 Mapowanie pól KSeF → Document / Invoice
| Element KSeF (XML) | Wartość w pliku | Document | Invoice (kanoniczny) |
|---|---|---|---|
| Naglowek/DataWytworzeniaFa | 2026-02-22T14:14:40Z | (meta / profil ksefAcquisitionDate) | ksefAcquisitionDate (jeśli z KSeF) |
| Podmiot1: NIP, Nazwa, Adres | 7671004218, TERG S.A., Za Dworcem 1D 77-400 Złotów | participant[0] → PartyRole (seller), Party: identifier NIP, name, address | seller → PartyRole; Party jak wyżej |
| Podmiot2: NIP, Nazwa, Adres | 9542685559, KAMSOFT SPÓŁKA AKCYJNA, ul. 1 Maja 133 40-235 Katowice | participant[1] → PartyRole (buyer), Party: identifier NIP, name, address | buyer → PartyRole; Party jak wyżej |
| Fa/P_2 (numer faktury) | FS-783004/26/MEPL1/02 | identifier (system=company), value | identifier (system=company), value |
| Fa/P_6 (data wystawienia) | 2026-02-22 | issueDate | issueDate |
| Fa/P_1 (data sprzedaży) | 2026-02-22 | attribute saleDate | saleDate |
| Fa/KodWaluty | PLN | attribute currency | currency |
| Fa/P_13_1 (netto 23%) | 812.20 | attribute total-net | totalNet |
| Fa/P_14_1 (VAT 23%) | 186.80 | attribute total-vat | totalVat |
| Fa/P_15 (należność ogółem) | 999.00 | attribute total-gross | totalGross |
| FaWiersz: NrWierszaFa, P_7, P_8A, P_8B, P_9B, P_12 | 1, „Klawiatura APPLE…”, szt, 1, 812.20 netto, 23% | position[0] invoice-line: positionNo, valueString, quantity, unitPriceNet, netAmount, vatRate, vatAmount | position[0]: positionNo, description, quantity, unitPriceNet, netAmount, vatRate, vatAmount |
| Platnosc/FormaPlatnosci, DataZaplaty | 6, 2026-02-20 | attribute paymentMethod, paymentDate | paymentMethod; (data zapłaty w attribute) |
| WarunkiTransakcji/NrZamowienia | 02469444552 | relatedDocument lub attribute | relatedDocument / attribute |
| (identyfikator KSeF z nazwy pliku) | 7671004218-20260222-644401C00054-A6 | identifier (system=https://ksef.mf.gov.pl/, value) | identifier (system KSeF, value) |
Wartości netto/VAT: P_13_1 = 812,20 PLN (suma netto), P_14_1 = 186,80 PLN (VAT), P_15 = 999,00 PLN (brutto). Jedna pozycja: 1 szt × 812,20 = 812,20 netto, VAT 23% = 186,80.
3.2 Ta sama faktura jako Document (profil FK)
{
"resourceType": "Document",
"id": "doc-ksef-7671004218-20260222",
"meta": { "lastModified": "2026-02-22T14:14:40Z" },
"identifier": [
{ "system": "https://api-erp.kamsoft.pl/ns/company", "value": "FS-783004/26/MEPL1/02" },
{ "system": "https://ksef.mf.gov.pl/", "value": "7671004218-20260222-644401C00054-A6" }
],
"type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-type", "code": "invoice", "display": "Faktura" }] },
"status": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-status", "code": "issued", "display": "Wystawiona" }] },
"issueDate": "2026-02-22",
"attribute": [
{ "url": "https://api-erp.kamsoft.pl/ns/fk/saleDate", "valueDate": "2026-02-22" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/ksefAcquisitionDate", "valueDateTime": "2026-02-22T14:14:40Z" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/paymentMethod", "valueCodeableConcept": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/payment-method", "code": "6", "display": "Forma płatności 6" }] } },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/paymentDate", "valueDate": "2026-02-20" }
],
"participant": [
{ "reference": "#partyRole-seller", "display": "TERG S.A." },
{ "reference": "#partyRole-buyer", "display": "KAMSOFT SPÓŁKA AKCYJNA" }
],
"position": [
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line", "display": "Wiersz faktury" }] },
"positionNo": 1,
"valueString": "Klawiatura APPLE Magic Keyboard z Touch ID",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 1, "unit": "szt" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "unit-price" }] }, "valueMoney": { "value": 812.20, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 812.20, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 186.80, "currency": "PLN" } }
],
"valueCodeableConcept": [
{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] }
],
"attribute": [{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "2044591" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "vat-summary-line", "display": "Podsumowanie VAT" }] },
"positionNo": 2,
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 812.20, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 186.80, "currency": "PLN" } }
],
"valueCodeableConcept": [
{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] }
]
}
],
"attribute": [
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-net" }] }, "valueMoney": { "value": 812.20, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-vat" }] }, "valueMoney": { "value": 186.80, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-gross" }] }, "valueMoney": { "value": 999.00, "currency": "PLN" } }
],
"relatedDocument": [{ "identifier": { "system": "https://api-erp.kamsoft.pl/ns/order", "value": "02469444552" } }],
"contained": [
{
"resourceType": "Party",
"id": "party-seller",
"identifier": [{ "system": "urn:pl:nip", "value": "7671004218" }],
"name": "TERG S.A.",
"address": [{ "use": "work", "line": ["Za Dworcem 1D 77-400 Złotów"], "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-seller",
"party": { "reference": "#party-seller" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "seller", "display": "Wystawca" }] }
},
{
"resourceType": "Party",
"id": "party-buyer",
"identifier": [{ "system": "urn:pl:nip", "value": "9542685559" }],
"name": "KAMSOFT SPÓŁKA AKCYJNA",
"address": [{ "use": "work", "line": ["ul. 1 Maja 133 40-235 Katowice"], "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-buyer",
"party": { "reference": "#party-buyer" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "buyer", "display": "Nabywca" }] }
}
]
}
3.3 Ta sama faktura jako Invoice (model kanoniczny)
{
"resourceType": "Invoice",
"id": "inv-ksef-7671004218-20260222",
"meta": { "lastModified": "2026-02-22T14:14:40Z" },
"identifier": [
{ "system": "https://api-erp.kamsoft.pl/ns/company", "value": "FS-783004/26/MEPL1/02" },
{ "system": "https://ksef.mf.gov.pl/", "value": "7671004218-20260222-644401C00054-A6" }
],
"type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-type", "code": "invoice", "display": "Faktura" }] },
"status": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-status", "code": "issued", "display": "Wystawiona" }] },
"issueDate": "2026-02-22",
"saleDate": "2026-02-22",
"seller": { "reference": "#partyRole-seller", "display": "TERG S.A." },
"buyer": { "reference": "#partyRole-buyer", "display": "KAMSOFT SPÓŁKA AKCYJNA" },
"totalNet": { "value": 812.20, "currency": "PLN" },
"totalVat": { "value": 186.80, "currency": "PLN" },
"totalGross": { "value": 999.00, "currency": "PLN" },
"currency": "PLN",
"paymentMethod": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/payment-method", "code": "6", "display": "Forma płatności 6" }] },
"ksefAcquisitionDate": "2026-02-22T14:14:40Z",
"position": [
{
"positionNo": 1,
"description": "Klawiatura APPLE Magic Keyboard z Touch ID",
"quantity": { "value": 1, "unit": "szt" },
"unitPriceNet": { "value": 812.20, "currency": "PLN" },
"netAmount": { "value": 812.20, "currency": "PLN" },
"vatRate": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23", "display": "23%" }] },
"vatAmount": { "value": 186.80, "currency": "PLN" },
"attribute": [{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/product-attribute", "code": "indeks" }] }, "valueString": "2044591" }]
}
],
"relatedDocument": [{ "identifier": { "system": "https://api-erp.kamsoft.pl/ns/order", "value": "02469444552" } }],
"contained": [
{
"resourceType": "Party",
"id": "party-seller",
"identifier": [{ "system": "urn:pl:nip", "value": "7671004218" }],
"name": "TERG S.A.",
"address": [{ "use": "work", "line": ["Za Dworcem 1D 77-400 Złotów"], "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-seller",
"party": { "reference": "#party-seller" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "seller", "display": "Wystawca" }] }
},
{
"resourceType": "Party",
"id": "party-buyer",
"identifier": [{ "system": "urn:pl:nip", "value": "9542685559" }],
"name": "KAMSOFT SPÓŁKA AKCYJNA",
"address": [{ "use": "work", "line": ["ul. 1 Maja 133 40-235 Katowice"], "country": "PL" }]
},
{
"resourceType": "PartyRole",
"id": "partyRole-buyer",
"party": { "reference": "#party-buyer" },
"role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "buyer", "display": "Nabywca" }] }
}
]
}
Uwagi do przykładu KSeF:
- Numer KSeF z nazwy pliku (
7671004218-20260222-644401C00054-A6) umieszczono w identifier zsystem: "https://ksef.mf.gov.pl/". - P_13_1 / P_14_1 / P_15 z Fa: suma netto 812,20 PLN, VAT 186,80 PLN, należność ogółem 999,00 PLN — jedna pozycja (1 szt, cena jedn. netto 812,20, VAT 23%).
- Indeks (2044591) z FaWiersz: w Document — w attribute pozycji (np.
fk/indeks); w modelu Invoice — w InvoicePosition.attribute. - Platnosc: FormaPlatnosci 6, DataZaplaty 2026-02-20 — w Document w attribute, w Invoice jako paymentMethod i opcjonalnie attribute z datą zapłaty.
- NrZamowienia 02469444552 — relatedDocument z identifier (system order, value).
4. Przykład: druga faktura KSeF (ORLEN → KAMSOFT) — Document i Invoice
Faktura z pliku 7740001454-20260217-85570C8000C8-4C.xml (ORLEN S.A. → KAMSOFT SPÓŁKA AKCYJNA): 8 wierszy (paliwa, płyny, usługi, opłaty autostradowe), w tym 3 pozycje z KwotaAkcyzy (GAZ, EFECTA DIESEL, EFECTA 95). Na poziomie dokumentu: P_13_1 (netto) 14 456,32 PLN, P_14_1 (VAT) 3 324,96 PLN, P_15 (brutto) 17 781,28 PLN; suma akcyzy z wierszy: 169,36 + 733,18 + 2 991,64 = 3 894,18 PLN. Dodatkowe elementy: MPP (mechanizm podzielonej płatności), załącznik integralny, rachunek bankowy, termin płatności, zamówienie.
4.1 Mapowanie wybranych pól KSeF (7740001454…) → Document / Invoice
| Element KSeF | Wartość | Document | Invoice |
|---|---|---|---|
| Podmiot1 | NIP 7740001454, ORLEN S.A., Płock ul. Chemików 7 | participant[0] → PartyRole(seller), Party | seller, contained Party |
| Podmiot2 | NIP 9542685559, KAMSOFT SPÓŁKA AKCYJNA, Katowice 1 Maja 133 | participant[1] → PartyRole(buyer), Party | buyer, contained Party |
| P_2 | 0491371089 | identifier (company) | identifier (company) |
| P_6 / P_1 | 2026-02-15 / 2026-02-17 | issueDate, attribute saleDate | issueDate, saleDate |
| P_13_1, P_14_1, P_15 | 14456.32, 3324.96, 17781.28 | attribute total-net, total-vat, total-gross | totalNet, totalVat, totalGross |
| KwotaAkcyzy (wiersze 1, 7, 8) | 169.36, 733.18, 2991.64 | position[].valueItem excise-amount | position[].exciseAmount |
| Suma akcyzy | 3894.18 | attribute total-excise | totalExcise |
| Platnosc: Termin, Forma 6, NrRB | 2026-03-08, 6, PL74… | attribute dueDate, paymentMethod, paymentAccount | dueDate, paymentMethod, paymentAccount |
| RachunekBankowy | PL74124069606666000007114375, PKOPPLPW | attribute paymentAccount (Reference BankAccount) | paymentAccount |
| DodatkowyOpis MPP | „Mechanizm podzielonej płatności” | attribute splitPayment | splitPayment true |
| NrZamowienia | DZF00/02066/001/2005 | relatedDocument | relatedDocument |
| Id. KSeF (np. z pliku) | 7740001454-20260217-85570C8000C8-4C | identifier (system KSeF) | identifier (system KSeF) |
4.2 Faktura ORLEN jako Document (profil FK) — nagłówek i pozycje
{
"resourceType": "Document",
"id": "doc-ksef-7740001454-20260217",
"meta": { "lastModified": "2026-02-17T18:56:27+01:00" },
"identifier": [
{ "system": "https://api-erp.kamsoft.pl/ns/company", "value": "0491371089" },
{ "system": "https://ksef.mf.gov.pl/", "value": "7740001454-20260217-85570C8000C8-4C" }
],
"type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-type", "code": "invoice", "display": "Faktura" }] },
"status": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-status", "code": "issued", "display": "Wystawiona" }] },
"issueDate": "2026-02-15",
"attribute": [
{ "url": "https://api-erp.kamsoft.pl/ns/fk/saleDate", "valueDate": "2026-02-17" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/dueDate", "valueDate": "2026-03-08" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/paymentMethod", "valueCodeableConcept": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/payment-method", "code": "6" }] } },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/paymentAccount", "valueReference": { "reference": "BankAccount/ba-orlen-001", "display": "PL74124069606666000007114375" } },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/splitPayment", "valueBoolean": true },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/ksefAcquisitionDate", "valueDateTime": "2026-02-17T18:56:27+01:00" }
],
"participant": [
{ "reference": "#partyRole-seller", "display": "ORLEN S.A." },
{ "reference": "#partyRole-buyer", "display": "KAMSOFT SPÓŁKA AKCYJNA" }
],
"position": [
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 1,
"valueString": "GAZ - OSOBOWE",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 457.46, "unit": "L" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 1024.24, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 235.57, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "excise-amount" }] }, "valueMoney": { "value": 169.36, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [
{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-06230-3" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/gtu", "valueString": "GTU_02" }
]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 2,
"valueString": "PŁYNY EKSPLOATACYJNE",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 20, "unit": "SZT" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 625.85, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 143.95, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-12230-0" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 3,
"valueString": "USŁUGI SAMOCHODOWE",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 5, "unit": "SZT" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 120.28, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 27.67, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-20230-0" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 4,
"valueString": "OPŁATA AUTOSTRADOWA",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 9, "unit": "SZT" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 273.17, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 62.83, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-36230-0" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 5,
"valueString": "OPŁATA AUTOSTRADOWA A4",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 17, "unit": "SZT" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 234.96, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 54.04, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-36230-1" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 6,
"valueString": "OPŁATA AUTOSTRADOWA A1",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 13, "unit": "SZT" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 66.50, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 15.30, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-36230-2" }]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 7,
"valueString": "EFECTA DIESEL- OSOBOWY",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 632.05, "unit": "L" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 3102.58, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 713.59, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "excise-amount" }] }, "valueMoney": { "value": 733.18, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [
{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-01230-1" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/gtu", "valueString": "GTU_02" }
]
},
{
"code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-position-type", "code": "invoice-line" }] },
"positionNo": 8,
"valueString": "EFECTA 95 - OSOBOWY",
"valueItem": [
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "quantity" }] }, "valueQuantity": { "value": 1956.6, "unit": "L" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "net-amount" }] }, "valueMoney": { "value": 9008.74, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "vat-amount" }] }, "valueMoney": { "value": 2072.01, "currency": "PLN" } },
{ "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/quantity-item-type", "code": "excise-amount" }] }, "valueMoney": { "value": 2991.64, "currency": "PLN" } }
],
"valueCodeableConcept": [{ "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }],
"attribute": [
{ "url": "https://api-erp.kamsoft.pl/ns/fk/indeks", "valueString": "S-03230-1" },
{ "url": "https://api-erp.kamsoft.pl/ns/fk/gtu", "valueString": "GTU_02" }
]
}
],
"attribute": [
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-net" }] }, "valueMoney": { "value": 14456.32, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-vat" }] }, "valueMoney": { "value": 3324.96, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-excise" }] }, "valueMoney": { "value": 3894.18, "currency": "PLN" } },
{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-attribute-type", "code": "total-gross" }] }, "valueMoney": { "value": 17781.28, "currency": "PLN" } }
],
"relatedDocument": [{ "identifier": { "system": "https://api-erp.kamsoft.pl/ns/order", "value": "DZF00/02066/001/2005" } }],
"contained": [
{ "resourceType": "Party", "id": "party-seller", "identifier": [{ "system": "urn:pl:nip", "value": "7740001454" }], "name": "ORLEN S.A.", "address": [{ "use": "work", "line": ["09-411 Płock, ul. Chemików 7"], "country": "PL" }] },
{ "resourceType": "PartyRole", "id": "partyRole-seller", "party": { "reference": "#party-seller" }, "role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "seller" }] } },
{ "resourceType": "Party", "id": "party-buyer", "identifier": [{ "system": "urn:pl:nip", "value": "9542685559" }], "name": "KAMSOFT SPÓŁKA AKCYJNA", "address": [{ "use": "work", "line": ["40-235 KATOWICE, 1 MAJA 133"], "country": "PL" }] },
{ "resourceType": "PartyRole", "id": "partyRole-buyer", "party": { "reference": "#party-buyer" }, "role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "buyer" }] } }
]
}
4.3 Faktura ORLEN jako Invoice (model kanoniczny) — skrót pozycji
Nagłówek jak wyżej; position[] jako InvoicePosition z exciseAmount i exciseType (opcjonalnie) w wierszach 1, 7, 8. Przykład jednej pozycji z akcyzą i jednej bez:
{
"resourceType": "Invoice",
"id": "inv-ksef-7740001454-20260217",
"identifier": [
{ "system": "https://api-erp.kamsoft.pl/ns/company", "value": "0491371089" },
{ "system": "https://ksef.mf.gov.pl/", "value": "7740001454-20260217-85570C8000C8-4C" }
],
"type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-type", "code": "invoice" }] },
"status": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/document-status", "code": "issued" }] },
"issueDate": "2026-02-15",
"saleDate": "2026-02-17",
"dueDate": "2026-03-08",
"seller": { "reference": "#partyRole-seller", "display": "ORLEN S.A." },
"buyer": { "reference": "#partyRole-buyer", "display": "KAMSOFT SPÓŁKA AKCYJNA" },
"totalNet": { "value": 14456.32, "currency": "PLN" },
"totalVat": { "value": 3324.96, "currency": "PLN" },
"totalExcise": { "value": 3894.18, "currency": "PLN" },
"totalGross": { "value": 17781.28, "currency": "PLN" },
"currency": "PLN",
"paymentMethod": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/payment-method", "code": "6" }] },
"paymentAccount": { "reference": "BankAccount/ba-orlen-001", "display": "PL74124069606666000007114375" },
"splitPayment": true,
"ksefAcquisitionDate": "2026-02-17T18:56:27+01:00",
"relatedDocument": [{ "identifier": { "system": "https://api-erp.kamsoft.pl/ns/order", "value": "DZF00/02066/001/2005" } }],
"position": [
{ "positionNo": 1, "description": "GAZ - OSOBOWE", "quantity": { "value": 457.46, "unit": "L" }, "netAmount": { "value": 1024.24, "currency": "PLN" }, "vatRate": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }, "vatAmount": { "value": 235.57, "currency": "PLN" }, "exciseAmount": { "value": 169.36, "currency": "PLN" }, "exciseType": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/excise-type", "code": "fuel-lpg" }] }, "attribute": [{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/product-attribute", "code": "indeks" }] }, "valueString": "S-06230-3" }, { "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/gtu", "code": "GTU_02" }] }, "valueString": "GTU_02" }] },
{ "positionNo": 2, "description": "PŁYNY EKSPLOATACYJNE", "quantity": { "value": 20, "unit": "SZT" }, "netAmount": { "value": 625.85, "currency": "PLN" }, "vatRate": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/vat-rate", "code": "23" }] }, "vatAmount": { "value": 143.95, "currency": "PLN" }, "attribute": [{ "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/product-attribute", "code": "indeks" }] }, "valueString": "S-12230-0" }] }
],
"contained": [
{ "resourceType": "Party", "id": "party-seller", "identifier": [{ "system": "urn:pl:nip", "value": "7740001454" }], "name": "ORLEN S.A.", "address": [{ "use": "work", "line": ["09-411 Płock, ul. Chemików 7"], "country": "PL" }] },
{ "resourceType": "PartyRole", "id": "partyRole-seller", "party": { "reference": "#party-seller" }, "role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "seller" }] } },
{ "resourceType": "Party", "id": "party-buyer", "identifier": [{ "system": "urn:pl:nip", "value": "9542685559" }], "name": "KAMSOFT SPÓŁKA AKCYJNA", "address": [{ "use": "work", "line": ["40-235 KATOWICE, 1 MAJA 133"], "country": "PL" }] },
{ "resourceType": "PartyRole", "id": "partyRole-buyer", "party": { "reference": "#party-buyer" }, "role": { "coding": [{ "system": "https://api-erp.kamsoft.pl/ns/party-role", "code": "buyer" }] } }
]
}
Pozostałe 6 pozycji (3–8) dodaje się analogicznie; wiersze 7 i 8 zawierają exciseAmount (733,18 i 2 991,64 PLN). W oryginale KSeF załącznik (Zalacznik) z tabelami szczegółowymi paliw można mapować na Document.attachment lub osobny zasób.
5. Odniesienia
- Faktura i KSeF (Document) — mapowanie i weryfikacja, że format faktury (w tym pod KSeF) mieści się w obiekcie
- Model kanoniczny Invoice i InvoicePosition — struktura zasobu Invoice i pozycji
- Document, DocumentPosition — rdzeń dokumentu i pozycji
- Party, PartyRole — strony faktury (wystawca, nabywca)
- Systemy kodów — document-attribute-type, quantity-item-type, vat-rate, excise-type