Přijímání self-billing dokumentů: SMP capabilities a flow zpracování.
Jako dodavatel přijímáte self-billing faktury od Vašich kupujících. Kupující vystaví fakturu Vaším jménem a odešle ji přes síť Peppol. Tento článek popisuje, jakou registraci potřebujete a jak přijaté dokumenty zpracujete.
Self-billing faktury se doručují stejným způsobem jako běžné nákupní faktury. PSB odešle webhook notifikaci a dokument můžete stáhnout přes PurchaseInvoice endpoint. Rozdíl je v registraci a typu dokumentu.
Flow přijetí:
389) přes PSBInvoiceReceived na Váš webhookPro přijímání self-billing faktur musí být Vaše organizace registrována v Peppol SMP. Jaká registrace je potřeba, závisí na variantě:
Pokud jste již registrováni pro přijímání běžných NLCIUS faktur, nemusíte dělat nic navíc. Self-billing faktury s InvoiceTypeCode 389 se doručují přes stejný profil. PSB automaticky rozpozná typ dokumentu.
Pro profil BIS Self-Billing 3.0 je potřeba samostatná registrace. Tento profil má vlastní CustomizationID a ProfileID a vyžaduje specifickou SMP konfiguraci.
Nakonfigurujte self-billing capability přes Peppol config API:
PUT /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json
{
"selfBilling": {
"state": "on"
}
}
Bez této registrace Vás kupující používající profil BIS Self-Billing 3.0 nemohou najít přes Peppol SMP lookup.
Použijte stejný topic jako pro běžné nákupní faktury:
{
"action": "https://mijn-systeem.nl/webhook/invoices#mijnSecretKey",
"topics": ["InvoiceReceived"]
}
Self-billing faktury přicházejí jako eventy InvoiceReceived. Od běžných faktur je odlišíte kontrolou InvoiceTypeCode v XML dokumentu: 389 pro self-billing fakturu, 261 pro self-billing dobropis.
Dokument stáhnete stejným způsobem jako běžnou nákupní fakturu:
GET /api/v1/{partyId}/purchaseInvoice/{documentId}/download HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Volitelně můžete přes targetDocumentTypeId vyžádat dokument v jiném formátu, pokud to Váš systém vyžaduje.
Po stažení můžete v XML dokumentu zkontrolovat, zda jde o self-billing fakturu:
<!-- InvoiceTypeCode 389 = self-billing faktura -->
<InvoiceTypeCode>389</InvoiceTypeCode>
<!-- InvoiceTypeCode 261 = self-billing dobropis -->
<InvoiceTypeCode>261</InvoiceTypeCode>
U self-billing faktury je AccountingSupplierParty Vaše organizace (dodavatel), zatímco AccountingCustomerParty je kupující, který fakturu vystavil.
Po přijetí můžete odeslat Invoice Response kupujícímu k potvrzení zpracování nebo zamítnutí faktury. Flow je identický s běžnými fakturami:
POST /api/v1/{partyId}/purchaseInvoice/{documentId}/response HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json
{
"status": "AP",
"clarificationCode": "NON",
"actionCode": "NOA"
}
Podívejte se na Odeslání Invoice Response pro kompletní přehled stavových kódů a clarification codes.
Retenční pravidla pro self-billing dokumenty jsou stejná jako pro běžné nákupní faktury: 90 dní uchovávání po přijetí, 7 dní po stažení. Stahujte dokumenty včas a ukládejte je ve vlastním systému.
Ne, self-billing používá stejný topic jako běžné nákupní faktury: InvoiceReceived. Self-billing rozlišíte ve zpracování čtením InvoiceTypeCode v XML (389 pro fakturu, 261 pro dobropis).
Pokud již přijímáte nákupní faktury NLCIUS, tato registrace pokrývá i NLCIUS self-billing s kódem 389 nebo 261. Pro BIS Self-Billing 3.0 je potřeba samostatná capability; nastavte selfBilling.state na on přes PUT /api/v1/peppol/config, jinak Vás kupující pro tento profil v SMP nenajdou.
Použijte GET /api/v1/{partyId}/purchaseInvoice/{documentId}/download jako u každé nákupní faktury. S parametrem dotazu targetDocumentTypeId můžete požádat o jiný cílový formát, pokud to Váš back-end systém vyžaduje. Po stažení zkontrolujte v XML, která strana je dodavatel a která kupující podle AccountingSupplierParty a AccountingCustomerParty.
Zda jako dodavatel přijímáte NLCIUS nebo BIS Self-Billing 3.0, závisí na tom, co kupující odešle. Ujistěte se, že máte správnou SMP registraci pro varianty, které Vaši kupující používají. V případě pochybností: registrujte se pro obě.
Zobrazit API dokumentaci