This action validates the given settlement report and accepts it for partner invoice generation. The settlement report must have a B2B invoice processor configured on the report's issuing operator. A cross-operator report — one issued by a service operator other than the partner's home operator, whose operatorId on the v1.1 settlement report differs from the partner's operator — is accepted with 202 when the issuing operator's B2B invoice processor is the platform's native invoice integration, and its invoices are issued in the issuing operator's name. It is rejected with 422 when the issuing operator uses another B2B invoice processor. The caller gets 403 on a cross-operator report when it lacks the permission to generate cross-operator B2B invoices, or when it is a partner or sub-operator admin.
A settlement can hold money owed to the operator, money owed to the partner, or both. Each direction that holds money gets its own invoice:
- Money owed to the operator produces a partner invoice. The operator is the seller.
- Money owed to the partner produces a self-billing invoice. The partner is the seller and the invoice is issued in the partner's name.
When money is owed in both directions, two invoices are issued. A report that holds no money in either direction is refused with 422.
Corrections on the report can lower the partner's share that an earlier self-billing invoice already carried. Issuing through this action then also issues partial self-billing credit notes against those earlier invoices. The credit notes belong to the earlier invoice's settlement report. A report that holds only such corrections and no invoice to issue is accepted, and only its credit notes are issued. expectedDocumentCount counts every document the request will produce, credit notes included, and expectedCreditNoteCount says how many of them are credit notes. The remaining expectedDocumentCount - expectedCreditNoteCount documents are invoices issued for the settlement report. A report with no invoice to issue and no credit note to issue is still refused with 422.
Invoices and credit notes are generated asynchronously after the 202 response. Poll GET resources/partner-invoices/v1.0 filtered by settlementReportId until the expectedDocumentCount - expectedCreditNoteCount invoices appear, and filtered by the earlier invoice's settlement report for its credit notes.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
