# ZP — APIs de terceiro em curl

```bash
# Variáveis (preencha com os dados recebidos da TX Fuel)
BASE=https://zp1.txfuel.com.br/api      # ou https://zp2.txfuel.com.br/api (o seu servidor)
TIPO=APP                                     # APP, REDE, CNPJ ou CPF
VALOR='NOME DO APP'                          # nome do app/rede, ou o CNPJ/CPF só com números
IDENTIFICADOR='seu-identificador'            # segredo: não publique nem grave em log
A=0                                          # id do app

# senha do dia (data de Brasília; funciona no Linux e no macOS)
SENHA=$(printf '%s' "$IDENTIFICADOR$(TZ=America/Sao_Paulo date +%F)$VALOR" | { md5sum 2>/dev/null || md5; } | cut -d' ' -f1)
AUTH="$TIPO=$(python3 -c 'import sys,urllib.parse;print(urllib.parse.quote(sys.argv[1]))' "$VALOR")&SENHA=$SENHA&A=$A"
```

## GET /v1/terceiro/cobranca

```bash
curl -s -X GET "$BASE/v1/terceiro/cobranca?$AUTH&id_convenio=10"
```

## POST /v1/terceiro/cobranca

```bash
curl -s -X POST "$BASE/v1/terceiro/cobranca?$AUTH" \
  -H 'Content-Type: application/json' \
  -d '{"id_convenio": 10, "tipo": "BOLETO", "cobrancas": [{"codigo_cobranca": "PED-1001", "documento_numero": 1001, "documento_data": "2026-11-12", "documento_valor": 150.0, "documento_vencimento": "2026-12-10", "documento_especie": "DM", "instrucoes": "NÃO RECEBER APÓS 30 DIAS DO VENCIMENTO", "perc_multa": 2.0, "perc_juros_dia": 0.033, "incluir_pix_boleto": true, "sacado": {"cpf_cnpj": "12345678909", "nome_razao_social": "CLIENTE EXEMPLO DA SILVA", "cep": "80000000", "logradouro": "RUA EXEMPLO", "numero": 100, "complemento": "", "bairro": "CENTRO", "localidade": "CURITIBA", "estado": "PR", "telefone": "", "celular": "41999990000", "email": "cliente@exemplo.com.br"}}]}'
```

## DELETE /v1/terceiro/cobranca

```bash
curl -s -X DELETE "$BASE/v1/terceiro/cobranca?$AUTH&id_cobranca=5001"
```

## GET /v1/terceiro/lote

```bash
curl -s -X GET "$BASE/v1/terceiro/lote?$AUTH&id_cob_convenio=10"
```

## GET /v1/terceiro/cartao

```bash
curl -s -X GET "$BASE/v1/terceiro/cartao?$AUTH&id_cob_cedente=25"
```

## POST /v1/terceiro/cartao

```bash
curl -s -X POST "$BASE/v1/terceiro/cartao?$AUTH" \
  -H 'Content-Type: application/json' \
  -d '{"id_cob_cedente": 25, "pag_nome_razao_social": "CLIENTE EXEMPLO DA SILVA", "pag_cpf_cnpj": "12345678909", "pag_cep": "80000000", "pag_logradouro": "RUA EXEMPLO", "pag_numero": 100, "pag_bairro": "CENTRO", "pag_localidade": "CURITIBA", "pag_estado": "PR", "pag_celular": "41999990000", "pag_email": "cliente@exemplo.com.br", "card_numero": "4111111111111111", "card_cvv": "123", "card_mes_vencimento": "12", "card_ano_vencimento": "2030", "card_nome_titular": "CLIENTE EXEMPLO", "card_cpf_cnpj_titular": "12345678909", "card_apelido": "CARTAO EMPRESA"}'
```

## PUT /v1/terceiro/cartao

```bash
curl -s -X PUT "$BASE/v1/terceiro/cartao?$AUTH" \
  -H 'Content-Type: application/json' \
  -d '{"card_nome_titular": "CLIENTE EXEMPLO", "card_cpf_cnpj_titular": "12345678909", "card_apelido": "CARTAO NOVO"}'
```

## DELETE /v1/terceiro/cartao

```bash
curl -s -X DELETE "$BASE/v1/terceiro/cartao?$AUTH"
```

## GET /v1/terceiro/cedente

```bash
curl -s -X GET "$BASE/v1/terceiro/cedente?$AUTH&id_cob_cedente=25"
```

## POST /v1/terceiro/cedente

```bash
curl -s -X POST "$BASE/v1/terceiro/cedente?$AUTH" \
  -H 'Content-Type: application/json' \
  -d '{"cedente": {"cpf_cnpj": "11222333000181", "nome_razao_social": "EMPRESA EXEMPLO LTDA", "cep": "80000000", "logradouro": "AVENIDA EXEMPLO", "numero": 1000, "complemento": "SALA 1", "bairro": "CENTRO", "localidade": "CURITIBA", "estado": "PR", "celular": "41988880000", "email": "financeiro@exemplo.com.br"}, "conta": {"id_cob_banco": 1, "descricao": "CONTA PRINCIPAL", "agencia": "1234", "agencia_dv": "0", "numero": "56789", "numero_dv": "0"}, "convenio": {"id_cob_integrador": 3, "id_cob_tipo": 1, "descricao": "BOLETO CONTA PRINCIPAL", "homologacao": "S", "webhook_url": "https://sistema.exemplo.com.br/webhook/zp", "parametros": {"val1": "<parâmetro 1 do integrador>", "val2": "<parâmetro 2 do integrador>"}}}'
```

## PUT /v1/terceiro/cedente

```bash
curl -s -X PUT "$BASE/v1/terceiro/cedente?$AUTH&id_cob_cedente=25" \
  -H 'Content-Type: application/json' \
  -d '{"convenio": {"id_cob_convenio": 10, "homologacao": "N"}}'
```

## POST /v1/terceiro/softwareHouse

```bash
curl -s -X POST "$BASE/v1/terceiro/softwareHouse?$AUTH&cnpj_software_house=11222333000181&id_plano=1&cpf=12345678909&nome=RESPONSAVEL EXEMPLO&celular=41999990000&email=responsavel@exemplo.com.br&senha_usuario=<senha>"
```

## GET /v1/terceiro/nfeChave

```bash
curl -s -X GET "$BASE/v1/terceiro/nfeChave?$AUTH"
```

## GET /v1/terceiro/nfeResumo

```bash
curl -s -X GET "$BASE/v1/terceiro/nfeResumo?$AUTH"
```

## GET /v1/terceiro/nfeRecebidaStatus

```bash
curl -s -X GET "$BASE/v1/terceiro/nfeRecebidaStatus?$AUTH"
```

## GET /v1/terceiro/cteChave

```bash
curl -s -X GET "$BASE/v1/terceiro/cteChave?$AUTH"
```

## GET /v1/terceiro/status

```bash
curl -s -X GET "$BASE/v1/terceiro/status?$AUTH"
```

## GET /v1/terceiro/consultarCep

```bash
curl -s -X GET "$BASE/v1/terceiro/consultarCep?$AUTH&cep=80000000"
```

## GET /v1/terceiro/localizarLocalidade

```bash
curl -s -X GET "$BASE/v1/terceiro/localizarLocalidade?$AUTH&q=curitiba"
```

## GET /v1/terceiro/validarPessoaFisica

```bash
curl -s -X GET "$BASE/v1/terceiro/validarPessoaFisica?$AUTH&documento=12345678909"
```

## GET /v1/terceiro/validarPessoaJuridica

```bash
curl -s -X GET "$BASE/v1/terceiro/validarPessoaJuridica?$AUTH&documento=11222333000181"
```

## GET /v1/terceiro/txObservacao

```bash
curl -s -X GET "$BASE/v1/terceiro/txObservacao?$AUTH"
```

## POST /v1/terceiro/txObservacao

```bash
curl -s -X POST "$BASE/v1/terceiro/txObservacao?$AUTH" \
  -H 'Content-Type: application/json' \
  -d '{"tabela": "cob_cobranca", "id": 5001, "observacao": "Cliente pediu segunda via"}'
```

## PUT /v1/terceiro/txObservacao

```bash
curl -s -X PUT "$BASE/v1/terceiro/txObservacao?$AUTH&id_tx_observacao=" \
  -H 'Content-Type: application/json' \
  -d '{"observacao": "Texto corrigido"}'
```

## DELETE /v1/terceiro/txObservacao

```bash
curl -s -X DELETE "$BASE/v1/terceiro/txObservacao?$AUTH&id_tx_observacao="
```