v1

latestOpenAPI 3.0.1Apache 2.02026-07-26401961.7 KB

Suppliers

Save business supplier

post/suppliers

Request body

supplier_namestring required

Supplier Name

supplier_tinstring required

Supplier Tax Identification Number (TIN)

emailstring

Supplier Email Address

phonestring

Supplier Phone Number. Required when onboarding a reverse invoicing supplier unless the business has been configured to allow it to be omitted

Example request

{
  "supplier_name": "John Doe Inc.",
  "supplier_tin": "P012345678P",
  "email": "accounts@johndoeinc.com",
  "phone": "+254712345678"
}

Response

Success

idstring required

Supplier ID

supplier_namestring required

Supplier Name

emailstring

Supplier Email

phonestring

Supplier Phone Number

supplier_tinstring required

Supplier Tax Identification Number (TIN)

taxpayer_type'INDIVIDUAL' | 'BUSINESS' required

Taxpayer Type

status'PENDING' | 'FAILED' | 'COMPLETED'

status against KRA

Example response

{
  "id": "supplier_01JS16JDB2B5ESZ8HWJ3CBYP5Y",
  "supplier_name": "John Doe Inc",
  "email": "accounts@johndoeinc.com",
  "phone": "+254712345678",
  "supplier_tin": "P012345678P",
  "taxpayer_type": "INDIVIDUAL",
  "invoicing": {
    "reverse_invoice_type": "REGULAR",
    "reverse_invoice_authorisation": "IMPLICIT"
  }
}