Customer certificates

Create customer certificate

This endpoint is used to create a new customer certificate in Anrok.

post/v1/seller/certificates/create

Request

  • Base URL: https://api.anrok.com
  • URL: https://api.anrok.com/v1/seller/certificates/create
  • Auth: HTTP bearer

Request body

customerIdstring required

The Anrok customer ID used to link transactions for the same customer and to look up tax exemption certificates for a customer. This is typically the billing system's customer ID with a prefix to disambiguate.

  • If customerId is provided without customerName, that customer object must already exist in Anrok.
  • If both customerId and customerName are provided, the customer object will be created if it is not already present.
  • Customer IDs are unique across the entire seller account.
customerNamestring

The name of the customer. This is used for display purposes only.

effectiveDateBeginstring date required

Effective date of certificate

exemptionNumberstring

Certificate exemption number. This is used for display purposes only.

notesstring

Optional internal notes.

type'agricultural' | 'directPay' | 'educational' | 'energy' | 'governmentFederal' | 'governmentOther' | 'governmentState' | 'healthcare' | 'manufacturing' | 'nativeAmericanTribal' | 'nonprofit' | 'other' | 'religious' | 'resale' | 'researchDevelopment' | 'null' nullable

The type of exemption the certificate represents. If omitted or null, no type is recorded.

  • agricultural: agricultural use.
  • directPay: direct pay permit.
  • educational: educational institution.
  • energy: energy-related exemption.
  • governmentFederal: federal government entity.
  • governmentOther: other government entity.
  • governmentState: state government entity.
  • healthcare: healthcare organization.
  • manufacturing: used in manufacturing.
  • nativeAmericanTribal: Native American tribal entity.
  • nonprofit: nonprofit organization.
  • other: other exemption type.
  • religious: religious organization.
  • resale: purchased for resale.
  • researchDevelopment: research and development use.

Example request

{
  "customerId": "v1:1292",
  "customerName": "Acme Inc",
  "effectiveDateBegin": "2022-01-01",
  "exemptionNumber": "cert-105",
  "notes": "customer notes",
  "type": "resale",
  "certificateFile": {
    "name": "cert.png",
    "contentsBase64": "Y2VydC5wbmc="
  },
  "jurises": [
    {
      "jurisId": "us-MA",
      "registrationId": "reg-1234",
      "effectiveDateEndi": "2023-01-01",
      "notes": "Optional internal notes"
    }
  ]
}

Response

OK

idstring

Certificate ID

Changes

No recorded changes to this operation across all 1 revision of this API.