Create a customer

Returns 409 if another of the business's customers has the same buyer_tin.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length between 1 and 250

The buyer's registered (legal) name

string
length ≤ 250

The name the buyer trades under

string

The buyer's taxpayer identification number. Optional - buyers can be unregistered individuals. Exactly 10 characters when given, and unique among your customers. A receipt for a customer without one keeps the customer on the receipt and its printout but doesn't send the buyer to ZIMRA.

string

The buyer's VAT number; exactly 9 characters when given

string
length ≤ 20

Contact phone number

string
length ≤ 100

Contact email address

string
length ≤ 100

Address - province. Free text; GET /resources/provinces lists names to suggest

string
length ≤ 100

Address - city

string
length ≤ 100

Address - street

string
length ≤ 250

Address - house or building number

string
length ≤ 100

Address - district or suburb

metadata
object

Your own key-value pairs. Only applied on create; ignored by PUT

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json