POST/nfse/tomador

Register a customer

Registers a service customer (tomador) to simplify issuance. The response includes an ID to reuse in the invoice JSON. Notes: - Registering a customer is optional. All customer data can be sent in the issuance payload.

Production: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parameters

This route has no path or query parameters.

Request

cURL

curl -X POST 'https://api.otentecnologia.com.br/nfse/tomador' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json'

Responses

201Created

JSON

{
  "message": "Cadastro efetuado com sucesso",
  "data": {
    "cnpj": "00000000000"
  }
}

400Bad Request

401Unauthorized

JSON

{
  "error": {
    "message": "O token informado é inválido. Para o ambiente de produção, Acesse https://www.otentecnologia.com.br/, e gere o seu TOKEN de acesso"
  }
}

409Conflict

JSON

{
  "error": {
    "message": "Já existe um(a) Tomador com os parâmetros informados",
    "data": {
      "new": {
        "cnpj": "0000000000"
      },
      "current": {
        "cnpj": "0000000000",
        "razaoSocial": "Tomador de teste LTDA"
      }
    }
  }
}