BizKitHub
DocsAPI ReferencePurchase Invoice/bff/purchase-invoice/create
postPurchase InvoiceAdmin BFF

/bff/purchase-invoice/create

Header + items are persisted in one transaction. Items without an explicit vatClassificationId are auto-classified server-side (country-aware + rate-based). CNB exchange rate to CZK is resolved against taxDate (or issueDate as fallback) and snapshotted on the row, so EPO reports always use the original posting rate.

PurchaseInvoicepostBffPurchase-invoiceCreate

Parameters

21 body

21 total
Body · 21
vendorExternalNumberstring | null
vendorIdnumber | null
recipientIdnumber | null
currencyCodestringRequired

ISO-4217 currency code (e.g. CZK, EUR).

issueDatestringRequired

Issue date (YYYY-MM-DD).

dueDatestring | null
taxDatestring | null
receivedDatestring | null
paymentMethodstring | null
variableSymbolstring | null
constantSymbolstring | null
specificSymbolstring | null
vendorIbanstring | null
vendorSwiftstring | null
internalNoticestring | null
publicNoticestring | null
roundingnumber
Default: 0
isReverseChargeboolean
Default: false
isCreditNoteboolean
Default: false
parentIdnumber | null
itemsobject[]Required5 fields

At least one line is required.

Request

POST /bff/purchase-invoice/create

post
curl -X POST "https://api.bizkithub.com/bff/purchase-invoice/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "currencyCode": "example_currencyCode",
  "issueDate": "example_issueDate",
  "rounding": 0,
  "isReverseCharge": false,
  "isCreditNote": false,
  "items": [
    {
      "description": "example_description",
      "quantity": 0,
      "unitPrice": 0,
      "vatRate": 0
    }
  ]
}'

Response

JSON payload

{
  "success": true
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key