Create a Taxpayer

Learn about creating a taxpayer.

Create a taxpayer

EndpointMethodKey valueRequired fields
/config/v2/taxpayersPOSTcodecode, name, startDate

This request creates a taxpayer.

Sample request - Create taxpayer

{
  "code": "string",
  "name": "string",
  "partyTypeId": 0,
  "note": "string",
  "parentTaxpayerId": "123e4567-e89b-12d3-a456-426614174000",
  "startDate": "2021-01-01",
  "endDate": "2021-12-01",
  "adoptParentSetup": false,
  "filingEntity": true,
  "shippingTerms": "EXW",
  "discountMappings": [
    {
      "discountCategory": "GENERAL_DISCOUNT",
      "discountCode": "string"
    }
  ]
}

Sample response - Create taxpayer

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "code": "string",
  "name": "string",
  "partyTypeId": 0,
  "note": "string",
  "parentTaxpayerId": "123e4567-e89b-12d3-a456-426614174000",
  "startDate": "2021-01-01",
  "endDate": "2021-12-01",
  "adoptParentSetup": false,
  "filingEntity": true,
  "shippingTerms": "EXW",
  "discountMappings": [
    {
      "discountCategory": "GENERAL_DISCOUNT",
      "discountCode": "string"
    }
  ]
}