Criar Cliente

Cadastra um cliente/destinatário com consulta e autocompletar de dados na Receita Federal.

POSThttps://api.nfer.me/v1/customers

Chave de API (X-API-Key)

<sua_chave_api>

Headers da Requisição

X-API-Keystringobrigatório

Chave de API.

Corpo da Requisição (JSON Body)

cpfCnpjstringobrigatório

11 (CPF) ou 14 (CNPJ) dígitos numéricos.

Exemplo: 12345678000199

nomestringobrigatório

Razão social ou nome completo.

Exemplo: Cliente Exemplo LTDA

emailstring<email>opcional

E-mail para envio automático de DANFE/XML.

Exemplo: financeiro@exemplo.com.br

cepstringobrigatório

CEP (8 dígitos).

Exemplo: 01310100

logradourostringobrigatório

Rua ou avenida.

Exemplo: Avenida Paulista

numerostringobrigatório

Número do endereço.

Exemplo: 1000

Criar Cliente

curl --request POST \
  --url https://api.nfer.me/v1/customers \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "cpfCnpj": 12345678000199,
  "nome": "Cliente Exemplo LTDA",
  "email": "financeiro@exemplo.com.br",
  "cep": "01310100",
  "logradouro": "Avenida Paulista",
  "numero": 1000
}'

{
  "id": "cli_102030",
  "cpfCnpj": "12345678000199",
  "nome": "Cliente Exemplo LTDA",
  "ibge_municipio": "3550308"
}