Brokered Tax Invoice Issuance

Brokered issuance includes trustee information alongside the supplier and supplied party.

Workflow

Send the trustee’s information to the Register Issuer API. Save the returned issuerId.

curl -X POST https://xapi.bolta.io/v1/issuers \
  -H "Authorization: Basic {apiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "identificationNumber": "5648102684",
    "taxRegistrationId": null,
    "organizationName": "Trustee Company",
    "representativeName": "Trustee Representative"
  }'

Call GET /v1/issuers/{issuerId}/certificates/url to obtain a registration URL. After the trustee registers its certificate, check the result with the Retrieve Issuer Certificate Registration Status API.

Issue the brokered tax invoice

Send supplier, supplied, and trustee to the Issue Tax Invoice API.

Check the result

Receive the completion event by webhook or call the Retrieve Tax Invoice API. Trustee information is in invoice.trustee, and manager information is in invoice.trustee.manager.

Issuance request

curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
  -H "Authorization: Basic {apiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "YYYY-MM-DD",
    "purpose": "CLAIM",
    "taxType": "TAXABLE",
    "supplier": {
      "identificationNumber": "1234567891",
      "organizationName": "Principal Company",
      "representativeName": "Principal Representative",
      "manager": {
        "email": "supplier@example.com",
        "name": "Principal Manager"
      }
    },
    "supplied": {
      "identificationNumber": "0987654323",
      "organizationName": "Recipient Company",
      "representativeName": "Recipient Representative",
      "managers": [
        {
          "email": "recipient@example.com",
          "name": "Recipient Manager"
        }
      ]
    },
    "trustee": {
      "identificationNumber": "5648102684",
      "organizationName": "Trustee Company",
      "representativeName": "Trustee Representative",
      "manager": {
        "email": "trustee@example.com",
        "name": "Trustee Manager",
        "telephone": "010-1234-5678"
      }
    },
    "items": [
      {
        "date": "YYYY-MM-DD",
        "name": "Taxable brokered item",
        "supplyCost": 100000,
        "tax": 10000
      }
    ]
  }'

Trustee fields

Field	Required	Description
`identificationNumber`	Yes	Trustee business registration number
`organizationName`	Yes	Trustee organization name
`representativeName`	Yes	Trustee representative name
`taxRegistrationId`	No	Trustee sub-business place code
`address`	No	Trustee address
`businessItem`	No	Trustee business item
`businessType`	No	Trustee business type
`manager`	No	Trustee manager

manager supports email, name, and telephone. If you include manager, set at least one of these fields.

Tax by tax type

Brokered issuance follows the same tax rules as regular direct issuance.

Tax type (`taxType`)	Item tax (`items[].tax`)	Example
`TAXABLE`	A non-null tax amount	Supply cost `100000`, tax `10000`
`ZERO_RATE`	`0`	Supply cost `100000`, tax `0`
`TAX_FREE`	`null` or omitted	Supply cost `100000`, tax `null`

For complete requests, select Brokered taxable, Brokered zero-rate, or Brokered tax-free from the menu at the top of the code example panel in the Issue Tax Invoice API. On narrower screens, the code example panel appears below the main content.

API Introduction

API Guides

Use Cases

SDK / No-code

Workflow

Issuance request

Trustee fields

Tax by tax type

​Workflow

​Issuance request

​Trustee fields

​Tax by tax type

​Related documents

Workflow

Issuance request

Trustee fields

Tax by tax type

Related documents