Přijetí self-billing faktury přes API

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.

Jak přicházejí self-billing faktury?

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í:

  1. Kupující odešle self-billing fakturu (InvoiceTypeCode 389) přes PSB
  2. Síť Peppol nasměruje dokument na Váš Access Point
  3. PSB odešle event InvoiceReceived na Váš webhook
  4. Stáhnete a zpracujete dokument
SMP registrace

Pro 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ě:

Varianta NLCIUS

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.

BIS Self-Billing 3.0

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.

Konfigurace webhooku

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.

Stažení a zpracování dokumentu

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.

Rozpoznání self-billing faktury

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.

Odeslání Invoice Response

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.

Retence

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.

Často kladené otázky
Potřebuji samostatné webhooky pro self-billing?

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).

Jakou SMP registraci potřebuji pro NLCIUS oproti BIS Self-Billing 3.0?

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.

Jak stáhnu přijatou self-billing fakturu a mohu změnit formát?

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