{"info":{"_postman_id":"25c50185-d4b3-42da-9833-9c7206dd8c1b","name":"GTS - AUTOMAÇÃO BALANÇA","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"50463743","collectionId":"25c50185-d4b3-42da-9833-9c7206dd8c1b","publishedId":"2sBXVo8nqB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-29T21:09:33.000Z"},"item":[{"name":"Filial","id":"b5dd50d4-7e1f-4f95-a591-eabb7cb7e96d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"cnpj\":\"06855894000340\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/filiais/consulta","description":"

Consulta de Filial

Visão Geral

Este endpoint permite consultar informações detalhadas de uma filial/estabelecimento através do CNPJ. A consulta retorna os dados da filial de forma síncrona na resposta da requisição.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n

Response:

  {\n    \"acesso\": \"acesso negado\"\n  }\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/filiais/consulta
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
cnpj	string	Sim	CNPJ da filial (14 dígitos, apenas números)

Exemplo de Requisição

{\n  \"cnpj\": \"06855894000340\"\n}\n\n

Respostas

✅ Sucesso (200 OK)

Retorna os dados completos da filial encontrada.

{\n  \"M0_CODFIL\": \"0102103\",\n  \"M0_FILIAL\": \"MISTURADORA BALSAS\",\n  \"M0_CGC\": \"06855894000340\"\n}\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
M0_CODFIL	Código da filial no sistema
M0_FILIAL	Nome/Razão social da filial
M0_CGC	CNPJ da filial consultada

❌ Erro de Autenticação (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou não foi fornecido.

{\n  \"acesso\": \"acesso negado\"\n}\n\n

❌ Filial Não Encontrada (404 Not Found)

Retornado quando não existe uma filial cadastrada com o CNPJ informado.

{\n  \"erro\": \"Filial não encontrada\"\n}\n\n

Observações

O CNPJ deve ser informado apenas com números, sem pontuação (formato: 14 dígitos)
\n
A consulta retorna os dados imediatamente na resposta (operação síncrona)
\n
Certifique-se de que o token de autenticação está válido antes de realizar a consulta
\n

\n","urlObject":{"path":["v1","filiais","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b5dd50d4-7e1f-4f95-a591-eabb7cb7e96d"},{"name":"Marca Veiculo","id":"9246881c-ecfe-4bde-863d-ecee492d2aa7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/veiculo/marca/consulta","description":"

Consulta de Marcas de Veículos

Visão Geral

Este endpoint permite consultar todas as marcas de veículos cadastradas no sistema. A consulta retorna um array com todas as marcas disponíveis de forma síncrona na resposta da requisição.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n

Response:

  {\n    \"acesso\": \"acesso negado\"\n  }\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/veiculo/marca/consulta
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

Este endpoint não requer body na requisição. Nenhum parâmetro no body é necessário.

Respostas

✅ Sucesso (200 OK)

Retorna um array com todas as marcas de veículos cadastradas no sistema.

[\n  {\n    \"X5_CHAVE\": \"01    \",\n    \"X5_DESCRI\": \"SCANIA\"\n  },\n  {\n    \"X5_CHAVE\": \"02    \",\n    \"X5_DESCRI\": \"VOLKSWAGEN\"\n  },\n  {\n    \"X5_CHAVE\": \"03    \",\n    \"X5_DESCRI\": \"M.BENZ\"\n  },\n  {\n    \"X5_CHAVE\": \"04    \",\n    \"X5_DESCRI\": \"VOLVO\"\n  },\n  {\n    \"X5_CHAVE\": \"05    \",\n    \"X5_DESCRI\": \"FIAT\"\n  },\n  {\n    \"X5_CHAVE\": \"06    \",\n    \"X5_DESCRI\": \"CHEVROLET\"\n  },\n  {\n    \"X5_CHAVE\": \"07    \",\n    \"X5_DESCRI\": \"MAN\"\n  },\n  {\n    \"X5_CHAVE\": \"08    \",\n    \"X5_DESCRI\": \"GUERRA\"\n  },\n  {\n    \"X5_CHAVE\": \"09    \",\n    \"X5_DESCRI\": \"IVECO\"\n  },\n  {\n    \"X5_CHAVE\": \"10    \",\n    \"X5_DESCRI\": \"LIBRELATO\"\n  }\n]\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
X5_CHAVE	Código da marca do veículo no sistema
X5_DESCRI	Nome/Descrição da marca do veículo

❌ Erro de Autenticação (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou não foi fornecido.

{\n  \"acesso\": \"acesso negado\"\n}\n\n

Notas Importantes

A consulta retorna todas as marcas cadastradas no sistema
\n
Não há paginação neste endpoint
\n
O token de autenticação deve ser válido e estar no formato Bearer Token
\n
A resposta é síncrona e retorna imediatamente com todos os dados disponíveis
\n

\n","urlObject":{"path":["v1","veiculo","marca","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"9246881c-ecfe-4bde-863d-ecee492d2aa7"},{"name":"Cores Veiculos","id":"ccfb2ca8-2fdb-4edc-b0f9-64ae893a187e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/veiculo/cores/consulta","description":"

Consulta de Cores de Veículos

Visão Geral

Este endpoint permite consultar todas as cores de veículos cadastradas no sistema. A consulta retorna um array com todas as cores disponíveis de forma síncrona na resposta da requisição.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
Response:
```
{\n  \"acesso\": \"acesso negado\"\n}\n
```
\n

Detalhes da Requisição

Método: POST
Endpoint: /v1/veiculo/cores/consulta
Content-Type: application/json

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

Este endpoint não requer body na requisição. Nenhum parâmetro no body é necessário.

Respostas

✅ Sucesso (200 OK)

Retorna um array com todas as cores de veículos cadastradas no sistema.

[\n  {\n    \"X5_CHAVE\": \"01    \",\n    \"X5_DESCRI\": \"BRANCO\"\n  },\n  {\n    \"X5_CHAVE\": \"02    \",\n    \"X5_DESCRI\": \"AZUL\"\n  },\n  {\n    \"X5_CHAVE\": \"03    \",\n    \"X5_DESCRI\": \"PRETO\"\n  },\n  {\n    \"X5_CHAVE\": \"04    \",\n    \"X5_DESCRI\": \"VERMELHO\"\n  },\n  {\n    \"X5_CHAVE\": \"05    \",\n    \"X5_DESCRI\": \"VERDE\"\n  },\n  {\n    \"X5_CHAVE\": \"06    \",\n    \"X5_DESCRI\": \"AMARELO\"\n  },\n  {\n    \"X5_CHAVE\": \"07    \",\n    \"X5_DESCRI\": \"CINZA\"\n  },\n  {\n    \"X5_CHAVE\": \"08    \",\n    \"X5_DESCRI\": \"PRATA\"\n  },\n  {\n    \"X5_CHAVE\": \"09    \",\n    \"X5_DESCRI\": \"DOURADO\"\n  },\n  {\n    \"X5_CHAVE\": \"10    \",\n    \"X5_DESCRI\": \"LARANJA\"\n  }\n]\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
X5_CHAVE	Código da cor do veículo no sistema
X5_DESCRI	Nome/Descrição da cor do veículo

❌ Erro de Autenticação (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou não foi fornecido.

{\n  \"acesso\": \"acesso negado\"\n}\n

Notas Importantes

A consulta retorna todas as cores cadastradas no sistema
Não há paginação neste endpoint
O token de autenticação deve ser válido e estar no formato Bearer Token
A resposta é síncrona e retorna imediatamente com todos os dados disponíveis

\n","urlObject":{"path":["v1","veiculo","cores","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ccfb2ca8-2fdb-4edc-b0f9-64ae893a187e"},{"name":"Tipo Veiculos","id":"b7ce05db-3f5d-4858-8ade-956b9d675701","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/veiculo/tipo/consulta","description":"

Consulta de Tipos de Veículos

Visão Geral

Este endpoint permite consultar todos os tipos de veículos cadastrados no sistema. A consulta retorna um array com todos os tipos disponíveis de forma síncrona na resposta da requisição.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
Response:
```
{\n  \"acesso\": \"acesso negado\"\n}\n
```
\n

Detalhes da Requisição

Método: POST
Endpoint: /v1/veiculo/tipo/consulta
Content-Type: application/json

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

Este endpoint não requer body na requisição. Nenhum parâmetro no body é necessário.

Respostas

✅ Sucesso (200 OK)

Retorna um array com todos os tipos de veículos cadastrados no sistema.

[\n  {\n    \"DUT_TIPVEI\": \"02\",\n    \"DUT_DESCRI\": \"CAMINHAO SIMPLES (TOCO)\"\n  },\n  {\n    \"DUT_TIPVEI\": \"03\",\n    \"DUT_DESCRI\": \"CAMINHAO SIMPLES (TOCO)\"\n  },\n  {\n    \"DUT_TIPVEI\": \"04\",\n    \"DUT_DESCRI\": \"CAMINHAO SIMPLES (TOCO)\"\n  },\n  {\n    \"DUT_TIPVEI\": \"05\",\n    \"DUT_DESCRI\": \"CAMINHAO TRUCK\"\n  },\n  {\n    \"DUT_TIPVEI\": \"06\",\n    \"DUT_DESCRI\": \"CAMINHAO TRUCK\"\n  },\n  {\n    \"DUT_TIPVEI\": \"07\",\n    \"DUT_DESCRI\": \"CAMINHAO TRUCK\"\n  },\n  {\n    \"DUT_TIPVEI\": \"08\",\n    \"DUT_DESCRI\": \"CAMINHAO TRUCK\"\n  },\n  {\n    \"DUT_TIPVEI\": \"09\",\n    \"DUT_DESCRI\": \"CAMINHAO BI TRUCK\"\n  },\n  {\n    \"DUT_TIPVEI\": \"13\",\n    \"DUT_DESCRI\": \"SEMI REBOQUE 2 EIXOS\"\n  },\n  {\n    \"DUT_TIPVEI\": \"14\",\n    \"DUT_DESCRI\": \"SEMI REBOQUE 2 EIXOS\"\n  }\n]\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
DUT_TIPVEI	Código do tipo de veículo no sistema
DUT_DESCRI	Nome/Descrição do tipo de veículo

❌ Erro de Autenticação (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou não foi fornecido.

{\n  \"acesso\": \"acesso negado\"\n}\n

Notas Importantes

A consulta retorna todos os tipos de veículos cadastrados no sistema de forma síncrona
Os códigos de tipo de veículo (DUT_TIPVEI) são únicos e identificam cada categoria de veículo
Alguns tipos de veículos podem ter o mesmo código com descrições diferentes dependendo da configuração do sistema
Os tipos incluem diversas categorias como caminhões simples (toco), trucks, bi-trucks e semi-reboques
Este endpoint é útil para popular dropdowns e validar tipos de veículos em outros processos do sistema
Não há paginação - todos os tipos são retornados em uma única requisição

\n","urlObject":{"path":["v1","veiculo","tipo","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b7ce05db-3f5d-4858-8ade-956b9d675701"},{"name":"Motorista","id":"ba70511a-8835-475d-9c46-0511b030f57c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"cpf\":\"80944957315\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/motorista/consulta","description":"

Consulta de Motorista

Visão Geral

Este endpoint permite consultar informações detalhadas de um motorista através do CPF.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n

Response:

  {\n  \"acesso\": \"acesso negado\"\n  }\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/motorista/consulta
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
cpf	string	Sim	Número do CPF do motorista (apenas números)

Exemplo de Requisição

{\n  \"cpf\": \"80944957315\"\n}\n\n

Respostas

✅ Sucesso (200 OK)

Retorna os dados completos do motorista encontrado.

{\n  \"DA4_COD\": \"000016\",\n  \"DA4_NOME\": \"RAIMUNDO NONATO R DA SILVA\",\n  \"DA4_TIPMOT\": \"Proprio\",\n  \"DA4_MAT\": \"001966\",\n  \"DA4_END\": \"R. 19\",\n  \"DA4_MUN\": \"BALSAS\",\n  \"DA4_EST\": \"MA\",\n  \"DA4_CEP\": \"65800000\",\n  \"DA4_CGC\": \"80944957315\",\n  \"DA4_NUMCNH\": \"03149996329\",\n  \"DA4_DTECNH\": \"20180726\",\n  \"DA4_MUNCNH\": \"SAO LUIS\",\n  \"DA4_ESTCNH\": \"MA\",\n  \"DA4_CATCNH\": \"E\",\n  \"DA4_DATNAS\": \"19821228\",\n  \"DA4_MSBLQL\": \"NÃO\",\n  \"DA4_BLQMOT\": \"NÃO\"\n}\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
DA4_COD	Código do motorista
DA4_NOME	Nome completo do motorista
DA4_TIPMOT	Tipo de motorista (Proprio/Terceiro)
DA4_MAT	Número de matrícula
DA4_END	Endereço
DA4_MUN	Município/Cidade
DA4_EST	Estado (UF)
DA4_CEP	Código postal (CEP)
DA4_CGC	CPF do motorista
DA4_NUMCNH	Número da CNH (Carteira Nacional de Habilitação)
DA4_DTECNH	Data de emissão da CNH (formato: AAAAMMDD)
DA4_MUNCNH	Município de emissão da CNH
DA4_ESTCNH	Estado de emissão da CNH
DA4_CATCNH	Categoria da CNH
DA4_DATNAS	Data de nascimento (formato: AAAAMMDD)
DA4_MSBLQL	Status de bloqueio MSB
DA4_BLQMOT	Status de bloqueio do motorista

❌ Erro - Motorista Não Encontrado

Quando o CPF informado não está cadastrado no sistema.

❌ Erro - Autenticação Inválida (401 Unauthorized)

Quando o token de autenticação é inválido ou está ausente.

Response:

{\n  \"acesso\": \"acesso negado\"\n}\n\n

Notas Importantes

O CPF deve ser enviado apenas com números, sem pontos ou hífens
\n
Todos os campos de data seguem o formato AAAAMMDD
\n
Os campos de texto podem conter espaços em branco no final
\n
O campo DA4_TIPMOT pode ter os valores \"Proprio\" ou \"Terceiro\"
\n
Os campos DA4_MSBLQL e DA4_BLQMOT indicam se há algum bloqueio ativo
\n

\n","urlObject":{"path":["v1","motorista","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ba70511a-8835-475d-9c46-0511b030f57c"},{"name":"Pesagem","id":"cb461f93-3b0a-480a-99a6-c92950a1c98a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"Z01_FILIAL\": \"0102113\",\r\n \"Z01_PRODUT\": \"03010000017\",\r\n \"Z01_VEICUL\": \"000032\",\r\n \"Z01_MOTORI\": \"000231\",\r\n \"Z01_PTARA\": 25760,\r\n \"Z01_PBRUTO\": 73440,\r\n \"Z01_DTTARA\": \"AAAAMMDD\",\r\n \"Z01_HTARA\": \"1611\",\r\n \"Z01_DTBRUT\": \"AAAAMMDD\",\r\n \"Z01_HTBRUT\": \"1611\",\r\n \"Z01_NUM_DI\": \"xxxxxxxx\",\r\n \"Z01_PLCVEI\": \"PTD7310\",\r\n \"Z01_NOMMOT\": \"XXXXXXXXXXXXXXXXXXXXXXXX\",\r\n \"Z01_PESAGEM\": 1,\r\n \"Z01_NAVIO\": \"\",\r\n \"Z01_NUM\": \"\",\r\n \"ID_AUTOMACAO\": \"98574852562525\",\r\n \"DATA_ENVIO\": \"2026012\",\r\n \"HORA_ENVIO\": \"14:42:40\",\r\n \"Z01_TIPO\": \"01\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/pesagem","description":"

Registro de Pesagem

Visão Geral

Este endpoint permite registrar dados de pesagem de veículos no sistema. Os dados são recebidos e processados de forma assíncrona, com o status final sendo retornado via webhook.

⚠️ Requisito de Webhook

IMPORTANTE: Este endpoint funciona de forma assíncrona. A resposta inicial apenas confirma o recebimento dos dados. O status final do processamento (sucesso ou erro) será enviado para o webhook configurado.

Certifique-se de ter um webhook configurado para receber as notificações de status do processamento da pesagem.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n
Response:
\n

{\n  \"acesso\": \"acesso negado\"\n}\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/pesagem
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
Z01_FILIAL	string	Sim	Código da filial
Z01_PRODUT	string	Sim	Código do produto
Z01_VEICUL	string	Sim	Código do veículo
Z01_MOTORI	string	Sim	Código do motorista
Z01_PTARA	number	Sim	Peso tara do veículo
Z01_PBRUTO	number	Sim	Peso bruto do veículo
Z01_DTTARA	string	Sim	Data da tara (formato: AAAAMMDD)
Z01_HTARA	string	Sim	Hora da tara (formato: HHMM)
Z01_DTBRUT	string	Sim	Data do peso bruto (formato: AAAAMMDD)
Z01_HTBRUT	string	Sim	Hora do peso bruto (formato: HHMM)
Z01_NUM_DI	string	Não	Número do documento de importação
Z01_PLCVEI	string	Sim	Placa do veículo
Z01_NOMMOT	string	Sim	Nome do motorista
Z01_PESAGEM	number	Sim	Número da pesagem
Z01_NAVIO	string	Não	Nome do navio
Z01_NUM	string	Não	Número
ID_AUTOMACAO	string	Sim	ID de automação do sistema
DATA_ENVIO	string	Sim	Data de envio
HORA_ENVIO	string	Sim	Hora de envio (formato: HH:MM:SS)
Z01_TIPO	string	Sim	Tipo de Pesagem. Veja os valores aceitos na tabela abaixo.

Valores Aceitos para Z01_TIPO

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Valor	Descrição
`01`	Pesagem de Grãos
`02`	Recebimento de Fertilizantes
`03`	Expedição de Fertilizantes
`04`	Recebimento Geral
`05`	Expedição Geral
`06`	Controle Portaria
`07`	Recebimento Colheita

Exemplo de Requisição

{\n  \"Z01_FILIAL\": \"0102113\",\n  \"Z01_PRODUT\": \"03010000017\",\n  \"Z01_VEICUL\": \"000032\",\n  \"Z01_MOTORI\": \"000231\",\n  \"Z01_PTARA\": 25760,\n  \"Z01_PBRUTO\": 73440,\n  \"Z01_DTTARA\": \"AAAAMMDD\",\n  \"Z01_HTARA\": \"1611\",\n  \"Z01_DTBRUT\": \"AAAAMMDD\",\n  \"Z01_HTBRUT\": \"1611\",\n  \"Z01_NUM_DI\": \"xxxxxxxx\",\n  \"Z01_PLCVEI\": \"PTD7310\",\n  \"Z01_NOMMOT\": \"XXXXXXXXXXXXXXXXXXXXXXXX\",\n  \"Z01_PESAGEM\": 1,\n  \"Z01_NAVIO\": \"\",\n  \"Z01_NUM\": \"\",\n  \"ID_AUTOMACAO\": \"98574852562525\",\n  \"DATA_ENVIO\": \"2026012\",\n  \"HORA_ENVIO\": \"14:42:40\",\n  \"Z01_TIPO\": \"01\"\n}\n\n

Respostas

✅ Sucesso (200 OK)

Retorna confirmação de recebimento dos dados. O processamento ocorre de forma assíncrona.

{\n  \"sucesso\": true,\n  \"numpesagem\": \"Cadastro recebido. Aguarde processamento\"\n}\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Indica que os dados foram recebidos com sucesso
numpesagem	Mensagem informando que o cadastro está em processamento

Nota: O status final do processamento será enviado via webhook. Aguarde a notificação para confirmar se a pesagem foi registrada com sucesso ou se houve algum erro durante o processamento.

❌ Erro de Autenticação (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou não foi fornecido.

{\n  \"acesso\": \"acesso negado\"\n}\n\n

Observações Importantes

⚠️ Processamento Assíncrono: A resposta 200 OK apenas confirma o recebimento. O resultado final virá via webhook.
\n
📅 Formato de Datas: Use o formato AAAAMMDD (ex: 20240115 para 15/01/2024)
\n
⏰ Formato de Horas: Use HHMM para horas de tara/bruto (ex: 1430 para 14:30) e HH:MM:SS para hora de envio
\n
🔢 Pesos: Informar valores numéricos sem formatação (ex: 25760 para 25.760 kg)
\n
🚛 Placa do Veículo: Informar no formato padrão brasileiro
\n

\n","urlObject":{"path":["v1","pesagem"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cb461f93-3b0a-480a-99a6-c92950a1c98a"},{"name":"Pesagem Incluir","id":"02f60ec0-d102-46b6-9719-b1181802ab47","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":""},"isInherited":false},"method":"POST","header":[{"key":"tenantId","value":"11,0102113","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"Z01_FILIAL\": \"0102113\",\r\n \"Z01_PRODUT\": \"03010000017\",\r\n \"Z01_VEICUL\": \"T996EUG \",\r\n \"Z01_MOTORI\": \"001227\",\r\n \"Z01_PTARA\": 0,\r\n \"Z01_PBRUTO\": 45000,\r\n \"Z01_DTTARA\": \"\",\r\n \"Z01_HTARA\": \"\",\r\n \"Z01_DTBRUT\": \"20260423\",\r\n \"Z01_HTBRUT\": \"1019\",\r\n \"Z01_NUM_DI\": \"13246546546546\",\r\n \"Z01_PLCVEI\": \"CUB3D87\",\r\n \"Z01_NOMMOT\": \"OTAILDO SOUSA DA SILVA\",\r\n \"Z01_PESAGEM\": 1,\r\n \"Z01_NAVIO\": \"TESTE\",\r\n \"Z01_NUM\": \"\",\r\n \"Z01_TIPO\": \"02\",\r\n \"Z01_BALBRT\": \"000003\",\r\n \"Z01_RFID\": \"1911031\",\r\n \"Z01_TIPOID\": \"RFID\",\r\n \"Z01_PBRUTOPORTO\": 0,\r\n \"Z01_PTARAPORTO\": 0,\r\n \"ID_GTS\": \"4831484\",\r\n \"ID_AUTOMACAO\": \"ENT_2048\",\r\n \"DATA_ENVIO\": \"20260429\",\r\n \"HORA_ENVIO\": \"16:09:38\"\r\n }\r\n","options":{"raw":{"language":"json"}}},"url":"{{url_protheus_Hom}}/api/v1/pesagem/incluir","description":"

Registro de Pesagem

Visão Geral

Este endpoint permite registrar dados de pesagem de veículos no sistema. Os dados são recebidos e processados de forma assíncrona, com o status final sendo retornado via webhook.

⚠️ Requisito de Webhook

Certifique-se de ter um webhook configurado para receber as notificações de status do processamento da pesagem.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n
Response:
\n

{\n  \"acesso\": \"acesso negado\"\n}\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/pesagem
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

Parâmetro	Tipo	Obrigatório	Descrição
Z01_FILIAL	string	Sim	Código da filial
Z01_PRODUT	string	Sim	Código do produto
Z01_VEICUL	string	Sim	Código do veículo
Z01_MOTORI	string	Sim	Código do motorista
Z01_PTARA	number	Sim	Peso tara do veículo
Z01_PBRUTO	number	Sim	Peso bruto do veículo
Z01_DTTARA	string	Sim	Data da tara (formato: AAAAMMDD)
Z01_HTARA	string	Sim	Hora da tara (formato: HHMM)
Z01_DTBRUT	string	Sim	Data do peso bruto (formato: AAAAMMDD)
Z01_HTBRUT	string	Sim	Hora do peso bruto (formato: HHMM)
Z01_NUM_DI	string	Não	Número do documento de importação
Z01_PLCVEI	string	Sim	Placa do veículo
Z01_NOMMOT	string	Sim	Nome do motorista
Z01_PESAGEM	number	Sim	Número da pesagem
Z01_NAVIO	string	Não	Nome do navio
Z01_NUM	string	Não	Número
ID_AUTOMACAO	string	Sim	ID de automação do sistema
DATA_ENVIO	string	Sim	Data de envio
HORA_ENVIO	string	Sim	Hora de envio (formato: HH:MM:SS)
Z01_TIPO	string	Sim	Tipo de Pesagem. Veja os valores aceitos na tabela abaixo.

Valores Aceitos para Z01_TIPO

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Valor	Descrição
`01`	Pesagem de Grãos
`02`	Recebimento de Fertilizantes
`03`	Expedição de Fertilizantes
`04`	Recebimento Geral
`05`	Expedição Geral
`06`	Controle Portaria
`07`	Recebimento Colheita

Exemplo de Requisição

{\n  \"Z01_FILIAL\": \"0102113\",\n  \"Z01_PRODUT\": \"03010000017\",\n  \"Z01_VEICUL\": \"000032\",\n  \"Z01_MOTORI\": \"000231\",\n  \"Z01_PTARA\": 25760,\n  \"Z01_PBRUTO\": 73440,\n  \"Z01_DTTARA\": \"AAAAMMDD\",\n  \"Z01_HTARA\": \"1611\",\n  \"Z01_DTBRUT\": \"AAAAMMDD\",\n  \"Z01_HTBRUT\": \"1611\",\n  \"Z01_NUM_DI\": \"xxxxxxxx\",\n  \"Z01_PLCVEI\": \"PTD7310\",\n  \"Z01_NOMMOT\": \"XXXXXXXXXXXXXXXXXXXXXXXX\",\n  \"Z01_PESAGEM\": 1,\n  \"Z01_NAVIO\": \"\",\n  \"Z01_NUM\": \"\",\n  \"ID_AUTOMACAO\": \"98574852562525\",\n  \"DATA_ENVIO\": \"2026012\",\n  \"HORA_ENVIO\": \"14:42:40\",\n  \"Z01_TIPO\": \"01\"\n}\n\n

Respostas

✅ Sucesso (200 OK)

Retorna confirmação de recebimento dos dados. O processamento ocorre de forma assíncrona.

{\n  \"sucesso\": true,\n  \"numpesagem\": \"Cadastro recebido. Aguarde processamento\"\n}\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
sucesso	Indica que os dados foram recebidos com sucesso
numpesagem	Mensagem informando que o cadastro está em processamento

Nota: O status final do processamento será enviado via webhook. Aguarde a notificação para confirmar se a pesagem foi registrada com sucesso ou se houve algum erro durante o processamento.

❌ Erro de Autenticação (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou não foi fornecido.

{\n  \"acesso\": \"acesso negado\"\n}\n\n

Observações Importantes

⚠️ Processamento Assíncrono: A resposta 200 OK apenas confirma o recebimento. O resultado final virá via webhook.
\n
📅 Formato de Datas: Use o formato AAAAMMDD (ex: 20240115 para 15/01/2024)
\n
⏰ Formato de Horas: Use HHMM para horas de tara/bruto (ex: 1430 para 14:30) e HH:MM:SS para hora de envio
\n
🔢 Pesos: Informar valores numéricos sem formatação (ex: 25760 para 25.760 kg)
\n
🚛 Placa do Veículo: Informar no formato padrão brasileiro
\n

\n","urlObject":{"path":["api","v1","pesagem","incluir"],"host":["{{url_protheus_Hom}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"02f60ec0-d102-46b6-9719-b1181802ab47"},{"name":"Cadastro Motorista","id":"999b96fd-89b1-47a7-9520-0c9b60d05b83","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":" {\r\n \"DA4_NOME\":\"JOAO VICTOR NOVAIS CAMILO\",\r\n \"DA4_FORNEC\":\"\", \r\n \"DA4_NREDUZ\":\"JOAO VICTOR NOVAIS\",\r\n \"DA4_CGC\":\"60942964357 \",\r\n \"DA4_NUMCNH\":\"2960387569 \",\r\n \"DA4_REGCNH\":\"6696350910\",\r\n \"DA4_DTECNH\":\"20250321\",\r\n \"DA4_DTVCNH\":\"20350210\",\t\r\n \"DA4_MUNCNH\":\"BALSAS\",\t\r\n \"DA4_ESTCNH\":\"MA\",\r\n \"DA4_CATCNH\":\"9\",\r\n \"ID_AUTOMACAO\":\"98574852562525\",\r\n \"DATA_ENVIO\":\"2026012\",\r\n \"HORA_ENVIO\":\"14:42:40\"\r\n }","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/motorista","description":"

Consulta de Motorista

Visão Geral

Este endpoint permite consultar informações detalhadas de um motorista através do CPF.

Requisito de Webhook

⚠️ Importante: Para receber a resposta do status do cadastro, é necessário configurar um webhook.

O status do cadastro do motorista é retornado de forma assíncrona via webhook. Isso significa que após enviar a requisição de cadastro, o sistema processará as informações e enviará o resultado para o endpoint do webhook configurado.

Observação: Sem um webhook configurado, você não receberá o status do cadastro do motorista. Certifique-se de ter um webhook ativo e corretamente configurado antes de realizar o cadastro.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n
Response:
\n
```
{\n  \"acesso\": \"acesso negado\"\n}\n
```
\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/motorista
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
DA4_NOME	string	Sim	Nome completo do motorista
DA4_FORNEC	string	Não	Código do fornecedor
DA4_NREDUZ	string	Sim	Nome reduzido do motorista
DA4_CGC	string	Sim	CPF do motorista (11 dígitos)
DA4_NUMCNH	string	Sim	Número da CNH
DA4_REGCNH	string	Sim	Registro da CNH
DA4_DTECNH	string	Sim	Data de emissão da CNH (formato AAAAMMDD)
DA4_DTVCNH	string	Sim	Data de validade da CNH (formato AAAAMMDD)
DA4_MUNCNH	string	Sim	Município de emissão da CNH
DA4_ESTCNH	string	Sim	Estado de emissão da CNH (UF)
DA4_CATCNH	string	Sim	Código da categoria da CNH. Valores possíveis: 1 = Categ. A, 2 = Categ. B, 3 = Categ. C, 4 = Categ. D, 5 = Categ. E, 6 = Categ. AB, 7 = Categ. AC, 8 = Categ. AD, 9 = Categ. AE
ID_AUTOMACAO	string	Sim	Identificador único da automação
DATA_ENVIO	string	Sim	Data de envio (formato AAAAMMDD)
HORA_ENVIO	string	Sim	Hora de envio (formato HH:MM:SS)

Exemplo de Requisição

{\n  \"DA4_NOME\": \"JOAO VICTOR NOVAIS CAMILO\",\n  \"DA4_FORNEC\": \"\",\n  \"DA4_NREDUZ\": \"JOAO VICTOR NOVAIS\",\n  \"DA4_CGC\": \"60942964357   \",\n  \"DA4_NUMCNH\": \"2960387569     \",\n  \"DA4_REGCNH\": \"6696350910\",\n  \"DA4_DTECNH\": \"20250321\",\n  \"DA4_DTVCNH\": \"20350210\",\n  \"DA4_MUNCNH\": \"BALSAS\",\n  \"DA4_ESTCNH\": \"MA\",\n  \"DA4_CATCNH\": \"9\",\n  \"ID_AUTOMACAO\": \"98574852562525\",\n  \"DATA_ENVIO\": \"2026012\",\n  \"HORA_ENVIO\": \"14:42:40\"\n}\n

Respostas

Sucesso (200 OK)

{\n  \"sucesso\": true,\n  \"numpesagem\": \"Cadastro recebido. Aguarde processamento\"\n}\n

Erro de Autenticação (401 Unauthorized)

{\n  \"acesso\": \"acesso negado\"\n}\n

Observações Importantes

Todos os campos de data devem seguir o formato AAAAMMDD
O campo DA4_CGC deve conter 11 dígitos do CPF
O processamento do cadastro é assíncrono e o resultado será enviado via webhook
Certifique-se de que o webhook esteja configurado corretamente para receber o status do cadastro

\n","urlObject":{"path":["v1","motorista"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"999b96fd-89b1-47a7-9520-0c9b60d05b83"},{"name":"Cadastro Veiculo","id":"caab2771-d42a-44b8-8974-a1cbb966becc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":" {\r\n \"DA3_PLACA\":\"JSMZ5J42\",\r\n \"DA3_DESC\":\"SCANIA/R540\", \r\n \"DA3_MUNPLA\":\"COLINAS \",\r\n \"DA3_ESTPLA\":\"MA\",\r\n \"DA3_MOTORI\":\"TT9EUJ\",\r\n \"DA3_CODFOR\":\"029743\",\r\n \"DA3_MARVEI\":\"01\",\t\r\n \"DA3_CORVEI\":\"01\",\t\r\n \"DA3_ANOMOD\":\"2025\",\r\n \"DA3_ANOFAB\":\"2025\",\r\n \"DA3_CHASSI\":\"9BSR6X400S4092614 \",\r\n \"DA3_TIPVEI\":\"11\",\r\n \"DA3_RENAVA\":\"1438087745 \",\r\n \"ID_AUTOMACAO\":\"98574852562525\",\r\n \"DATA_ENVIO\":\"2026012\",\r\n \"HORA_ENVIO\":\"14:42:40\"\r\n }","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/veiculo","description":"

Cadastro de Veículo

Visão Geral

Este endpoint permite registrar informações de veículos no sistema. O cadastro é processado de forma assíncrona e o status final é retornado via webhook.

Requisito de Webhook

⚠️ IMPORTANTE: Para receber a resposta do status do cadastro, é OBRIGATÓRIO configurar um webhook.

O status do cadastro do veículo é retornado de forma assíncrona via webhook. Isso significa que após enviar a requisição de cadastro, o sistema processará as informações e enviará o resultado para o endpoint do webhook configurado.

Observação: Sem um webhook configurado, você não receberá o status do cadastro do veículo. Certifique-se de ter um webhook ativo e corretamente configurado antes de realizar o cadastro.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
Response:

{\n  \"acesso\": \"acesso negado\"\n}\n

Detalhes da Requisição

Método: POST
Endpoint: /v1/veiculo
Content-Type: application/json

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

Todos os campos são obrigatórios:

Parâmetro	Tipo	Obrigatório	Descrição
DA3_PLACA	string	Sim	Placa do veículo
DA3_DESC	string	Sim	Descrição/modelo do veículo
DA3_MUNPLA	string	Sim	Município da placa
DA3_ESTPLA	string	Sim	Estado da placa (UF)
DA3_MOTORI	string	Sim	Número do motor
DA3_CODFOR	string	Sim	Código da transportadora - Obtido da API Transportadora
DA3_MARVEI	string	Sim	Código da marca do veículo - Obtido da API Marca Veículos
DA3_CORVEI	string	Sim	Código da cor do veículo - Obtido da API Cor de Veículos
DA3_ANOMOD	string	Sim	Ano do modelo (formato YYYY)
DA3_ANOFAB	string	Sim	Ano de fabricação (formato YYYY)
DA3_CHASSI	string	Sim	Número do chassi
DA3_TIPVEI	string	Sim	Código do tipo de veículo - Obtido da API Tipo de Veículo
DA3_RENAVA	string	Sim	Número do RENAVAM
ID_AUTOMACAO	string	Sim	ID de automação
DATA_ENVIO	string	Sim	Data de envio (formato YYYYMMDD)
HORA_ENVIO	string	Sim	Hora de envio (formato HH:MM:SS)

Exemplo de Body

{\n  \"DA3_PLACA\": \"JSMZ5J42\",\n  \"DA3_DESC\": \"SCANIA/R540\",\n  \"DA3_MUNPLA\": \"COLINAS\",\n  \"DA3_ESTPLA\": \"MA\",\n  \"DA3_MOTORI\": \"TT9EUJ\",\n  \"DA3_CODFOR\": \"029743\",\n  \"DA3_MARVEI\": \"01\",\n  \"DA3_CORVEI\": \"01\",\n  \"DA3_ANOMOD\": \"2025\",\n  \"DA3_ANOFAB\": \"2025\",\n  \"DA3_CHASSI\": \"9BSR6X400S4092614\",\n  \"DA3_TIPVEI\": \"11\",\n  \"DA3_RENAVA\": \"1438087745\",\n  \"ID_AUTOMACAO\": \"98574852562525\",\n  \"DATA_ENVIO\": \"2026012\",\n  \"HORA_ENVIO\": \"14:42:40\"\n}\n

APIs de Referência

Antes de cadastrar um veículo, você deve consultar as seguintes APIs para obter os códigos necessários:

1. API Marca Veículos

Finalidade: Obter o código da marca do veículo
Campo relacionado: DA3_MARVEI
Descrição: Consulte esta API para obter o código correto da marca do veículo (ex: Scania, Volvo, Mercedes, etc.)

2. API Cor de Veículos

Finalidade: Obter o código da cor do veículo
Campo relacionado: DA3_CORVEI
Descrição: Consulte esta API para obter o código correto da cor do veículo

3. API Transportadora

Finalidade: Obter o código da transportadora
Campo relacionado: DA3_CODFOR
Descrição: Consulte esta API para obter o código da transportadora/fornecedor

4. API Tipo de Veículo

Finalidade: Obter o código do tipo de veículo
Campo relacionado: DA3_TIPVEI
Descrição: Consulte esta API para obter o código do tipo de veículo (ex: caminhão, carreta, etc.)

Resposta

Sucesso (200 OK)

{\n  \"sucesso\": true,\n  \"numpesagem\": \"Cadastro recebido. Aguarde processamento\"\n}\n

Importante: Esta resposta indica apenas que o cadastro foi recebido pelo sistema. O status final do processamento será enviado via webhook.

Erro de Autenticação (401 Unauthorized)

{\n  \"acesso\": \"acesso negado\"\n}\n

Notas Importantes

✅ Todos os campos são obrigatórios - Certifique-se de preencher todos os parâmetros
🔗 Consulte as APIs de referência primeiro - Alguns valores (códigos de marca, cor, tipo e transportadora) devem ser obtidos de outras APIs
📡 Webhook é essencial - Sem webhook configurado, você não receberá o status final do cadastro
⏱️ Processamento assíncrono - Similar às APIs de Pesagem e Cadastro de Motorista, este endpoint processa o cadastro de forma assíncrona
📅 Formatos de data e hora - Atenção aos formatos: DATA_ENVIO (YYYYMMDD) e HORA_ENVIO (HH:MM:SS)

Fluxo Recomendado

Configure o webhook para receber notificações
Consulte as APIs de referência para obter os códigos necessários:
- Marca Veículos (DA3_MARVEI)
- Cor de Veículos (DA3_CORVEI)
- Transportadora (DA3_CODFOR)
- Tipo de Veículo (DA3_TIPVEI)
\n
Envie a requisição de cadastro com todos os campos preenchidos
Aguarde a confirmação de recebimento (200 OK)
Monitore o webhook para receber o status final do processamento

\n","urlObject":{"path":["v1","veiculo"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"caab2771-d42a-44b8-8974-a1cbb966becc"},{"name":"Clientes","id":"1c920003-eded-49b9-ad83-9c530a94e4d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"cpf_cnpj\":\"00052218384 \"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/cliente/consulta","description":"

Consulta de Cliente

Visão Geral

Este endpoint permite consultar informações detalhadas de um cliente através do CPF ou CNPJ.

⚠️ IMPORTANTE: Quando um cliente possui mais de uma loja cadastrada com o mesmo CNPJ, o resultado é retornado como um array de objetos, contendo os dados de todas as lojas. Caso contrário, retorna um único objeto.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n
Response:
\n
```
{\n\"acesso\": \"acesso negado\"\n}\n\n
```
\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/cliente/consulta
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
cpf_cnpj	string	Sim	Número do CPF ou CNPJ do cliente (apenas números)

Exemplo de Requisição

{\n  \"cpf_cnpj\": \"00052218384\"\n}\n\n

Respostas

✅ Sucesso - Cliente com Loja Única (200 OK)

Quando o cliente possui apenas uma loja cadastrada, retorna um único objeto:

{\n  \"A1_COD\": \"000056\",\n  \"A1_LOJA\": \"01\",\n  \"A1_NOME\": \"ARTUR MACEDO DOS SANTOS\",\n  \"A1_END\": \"RUA NONATO SANTOS\",\n  \"A1_BAIRRO\": \"CENTRO\",\n  \"A1_TIPO\": \"L\",\n  \"A1_EST\": \"MA\",\n  \"A1_ESTADO\": \"MARANHAO\",\n  \"A1_CEP\": \"65840000\",\n  \"A1_MUN\": \"SAO RAIMUNDO DAS MANGABEIRAS\",\n  \"A1_CGC\": \"00052218384\",\n  \"A1_INSCR\": \"ISENTO\",\n  \"A1_MSBLQL\": \"1\"\n}\n\n

✅ Sucesso - Cliente com Múltiplas Lojas (200 OK)

Quando o cliente possui mais de uma loja cadastrada com o mesmo CNPJ, retorna um array de objetos:

[\n  {\n    \"A1_COD\": \"000055\",\n    \"A1_LOJA\": \"01\",\n    \"A1_NOME\": \"ANTONIO AIRTON ARAUJO CARNEIRO\",\n    \"A1_END\": \"ESTRADA DOURADO KM 07\",\n    \"A1_BAIRRO\": \"ZONA RURAL\",\n    \"A1_TIPO\": \"L\",\n    \"A1_EST\": \"CE\",\n    \"A1_ESTADO\": \"CEARA\",\n    \"A1_CEP\": \"62880001\",\n    \"A1_MUN\": \"HORIZONTE\",\n    \"A1_CGC\": \"00051527120\",\n    \"A1_INSCR\": \"066636477\",\n    \"A1_MSBLQL\": \"1\"\n  },\n  {\n    \"A1_COD\": \"000055\",\n    \"A1_LOJA\": \"02\",\n    \"A1_NOME\": \"ANTONIO AIRTON ARAUJO CARNEIRO\",\n    \"A1_END\": \"FAZENDA SAO FRANCISCO\",\n    \"A1_BAIRRO\": \"ZONA RURAL\",\n    \"A1_TIPO\": \"L\",\n    \"A1_EST\": \"CE\",\n    \"A1_ESTADO\": \"CEARA\",\n    \"A1_CEP\": \"62850000\",\n    \"A1_MUN\": \"CASCAVEL\",\n    \"A1_CGC\": \"00051527120\",\n    \"A1_INSCR\": \"063211564\",\n    \"A1_MSBLQL\": \"1\"\n  },\n  {\n    \"A1_COD\": \"000055\",\n    \"A1_LOJA\": \"03\",\n    \"A1_NOME\": \"ANTONIO AIRTON ARAUJO CARNEIRO\",\n    \"A1_END\": \"RODOVIA CE 040 KM 27,5\",\n    \"A1_BAIRRO\": \"ZONA RURAL\",\n    \"A1_TIPO\": \"L\",\n    \"A1_EST\": \"CE\",\n    \"A1_ESTADO\": \"CEARA\",\n    \"A1_CEP\": \"60835175\",\n    \"A1_MUN\": \"AQUIRAZ\",\n    \"A1_CGC\": \"00051527120\",\n    \"A1_INSCR\": \"066752310\",\n    \"A1_MSBLQL\": \"1\"\n  }\n]\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
A1_COD	Código do cliente
A1_LOJA	Código da loja/filial
A1_NOME	Nome completo ou razão social do cliente
A1_END	Endereço completo
A1_BAIRRO	Bairro
A1_TIPO	Tipo de cliente
A1_EST	Estado (UF)
A1_ESTADO	Nome completo do estado
A1_CEP	Código postal (CEP)
A1_MUN	Município/Cidade
A1_CGC	CPF ou CNPJ do cliente
A1_INSCR	Inscrição estadual
A1_MSBLQL	Status do cliente: 1 = Inativo, 2 = Ativo

❌ Erro - Cliente Não Encontrado

{\n  \"message\": \"Cliente não encontrado\"\n}\n\n

❌ Erro - Parâmetros Inválidos (400 Bad Request)

{\n  \"error\": \"CPF/CNPJ inválido ou não informado\"\n}\n\n

Observações Importantes

Estrutura de Resposta Dinâmica: A aplicação cliente deve estar preparada para receber tanto um objeto único quanto um array de objetos
\n
Identificação de Lojas: O campo A1_LOJA identifica cada filial/loja do mesmo cliente
\n
Mesmo CNPJ, Endereços Diferentes: Cada loja pode ter endereço, município e inscrição estadual diferentes
\n
Status do Cliente: Verifique o campo A1_MSBLQL para determinar se o cliente está ativo (2) ou inativo (1)
\n
Validação Recomendada: Sempre verifique se a resposta é um array antes de iterar sobre os resultados
\n

Exemplo de Tratamento no Código

// Tratamento recomendado da resposta\nconst response = await fetch('/v1/cliente/consulta', {\n  method: 'POST',\n  headers: {\n    'Authorization': 'Bearer ' + token,\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({ cpf_cnpj: '00051527120' })\n});\nconst data = await response.json();\n// Normalizar para sempre trabalhar com array\nconst clientes = Array.isArray(data) ? data : [data];\nclientes.forEach(cliente => {\n  const status = cliente.A1_MSBLQL === '2' ? 'Ativo' : 'Inativo';\n  console.log(`Loja ${cliente.A1_LOJA}: ${cliente.A1_MUN} - Status: ${status}`);\n});\n\n

\n","urlObject":{"path":["v1","cliente","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1c920003-eded-49b9-ad83-9c530a94e4d1"},{"name":"Veiculos","id":"c9a56875-63de-4202-937f-cb128e4bc770","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"placa\":\"PTD7690\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/veiculo/consulta","description":"

Consulta de Veículo

Visão Geral

Este endpoint permite consultar informações detalhadas de um veículo através da placa.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n

Response:

  {\n    \"acesso\": \"acesso negado\"\n  }\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/veiculo/consulta
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
placa	string	Sim	Placa do veículo

Exemplo de Requisição

{\n  \"placa\": \"PTD7690\"\n}\n\n

Respostas

✅ Sucesso (200 OK)

Retorna os dados completos do veículo encontrado.

{\n  \"DA3_COD\": \"000037\",\n  \"DA3_CODBEM\": \"PTD7690\",\n  \"DA3_DESC\": \"M.BENZ/ACTROS 2651S 6X4\",\n  \"DA3_ESTPLA\": \"MA\",\n  \"DA3_MSBLQL\": \"1\",\n  \"DA3_MUNPLA\": \"SAO LUIS\",\n  \"DA3_PLACA\": \"PTD7690\",\n  \"DA3_PLACA2\": \"\",\n  \"DA3_PLACA3\": \"\",\n  \"DA3_TARA\": 10470,\n  \"DA3_TIPTRA\": \"1\",\n  \"DA3_TIPVEI\": \"11\",\n  \"DA3_XCOMPO\": \"22\",\n  \"DA3_XRBQ1\": \"000329\",\n  \"DA3_XRBQ3\": \"000276\"\n}\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
DA3_COD	Código do veículo
DA3_CODBEM	Código do bem/ativo
DA3_DESC	Descrição/modelo do veículo
DA3_ESTPLA	Estado (UF) da placa
DA3_MSBLQL	Status de bloqueio (1 = Bloqueado, 2 = Desbloqueado)
DA3_MUNPLA	Município/cidade da placa
DA3_PLACA	Placa do veículo
DA3_PLACA2	Placa secundária
DA3_PLACA3	Placa terciária
DA3_TARA	Peso da tara (em kg)
DA3_TIPTRA	Tipo de tração
DA3_TIPVEI	Tipo de veículo
DA3_XCOMPO	Composição
DA3_XRBQ1	Reboque 1
DA3_XRBQ3	Reboque 3

❌ Token Inválido (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou está ausente.

{\n  \"acesso\": \"acesso negado\"\n}\n\n

❌ Placa Não Encontrada

Retornado quando a placa informada não existe na base de dados.

{\n  \"placa\": \"Placa informada está incorreta ou não existe na Base\"\n}\n\n

Variáveis Utilizadas

Este endpoint utiliza as seguintes variáveis de ambiente:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Variável	Descrição
`{{url_base}}`	URL base da API
`{{token}}`	Token de autenticação Bearer

Exemplo de Requisição cURL

curl --location '{{url_base}}/v1/veiculo/consulta' \\\n--header 'Authorization: {{token}}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"placa\": \"PTD7690\"\n}'\n\n

Notas Importantes

A placa deve ser informada sem caracteres especiais (hífens ou espaços)
\n
O campo DA3_MSBLQL indica o status de bloqueio do veículo (1 = Bloqueado)
\n
Os campos de placa secundária e terciária podem estar vazios
\n
O peso da tara (DA3_TARA) é retornado em quilogramas
\n
Os campos de reboque (DA3_XRBQ1, DA3_XRBQ3) referenciam outros veículos/reboques associados
\n

\n","urlObject":{"path":["v1","veiculo","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c9a56875-63de-4202-937f-cb128e4bc770"},{"name":"Transportadora","id":"59a7f145-27ec-47fa-9d80-623b79a0e46c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"cnpj\":\"01209254000187\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/transportadora/consulta","description":"

Consulta de Transportadora

Visão Geral

Este endpoint permite consultar informações detalhadas de uma transportadora através do CNPJ.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n

Response:

  {\n    \"acesso\": \"acesso negado\"\n  }\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/transportadora/consulta
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
cnpj	string	Sim	CNPJ da transportadora

Exemplo de Requisição

{\n  \"cnpj\": \"01209254000187\"\n}\n\n

Respostas

✅ Sucesso (200 OK)

Retorna os dados completos da transportadora encontrada.

{\n  \"A4_COD\": \"000029\",\n  \"A4_NOME\": \"ANTONIO GALDINO VIEIRA FILHO - ME\",\n  \"A4_NREDUZ\": \"TRANSGALDINO\",\n  \"A4_END\": \"RUA 14\",\n  \"A4_BAIRRO\": \"POTOSI\",\n  \"A4_MUN\": \"BALSAS\",\n  \"A4_EST\": \"MA\",\n  \"A4_CGC\": \"01209254000187\",\n  \"A4_MSBLQL\": \"NÃO\",\n  \"A2_COD\": \"001144\",\n  \"A2_LOJA\": \"01\"\n}\n\n

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
A4_COD	Código da transportadora
A4_NOME	Nome completo da empresa
A4_NREDUZ	Nome reduzido/nome fantasia
A4_END	Endereço
A4_BAIRRO	Bairro
A4_MUN	Município/cidade
A4_EST	Estado (UF)
A4_CGC	CNPJ da transportadora
A4_MSBLQL	Status de bloqueio (SIM/NÃO)
A2_COD	Código do fornecedor
A2_LOJA	Loja do fornecedor

❌ Token Inválido (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou está ausente.

{\n  \"acesso\": \"acesso negado\"\n}\n\n

❌ CNPJ Não Encontrado

Retornado quando o CNPJ informado não existe na base de dados.

{\n  \"cnpj\": \"CNPJ informado está incorreto ou não existe na Base\"\n}\n\n

Variáveis Utilizadas

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Variável	Descrição
`{{url_base}}`	URL base da API
`{{token}}`	Token de autenticação Bearer

Notas Importantes

O CNPJ deve ser informado sem formatação (apenas números)
Certifique-se de que o token de autenticação está válido antes de fazer a requisição
O campo A4_MSBLQL indica se a transportadora está bloqueada no sistema

\n","urlObject":{"path":["v1","transportadora","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"59a7f145-27ec-47fa-9d80-623b79a0e46c"},{"name":"Pedido Venda","id":"f37b8317-bab3-48db-91fa-c52cf81d1a03","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"cnpj\":\"32566484600\",\r\n \"filial\":\"0101112\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base}}/v1/pedidovenda/consulta","description":"

Consulta de Pedido de Venda

Visão Geral

Este endpoint permite consultar pedidos de venda através do CNPJ ou CPF do cliente e código da filial. Retorna informações detalhadas dos pedidos incluindo dados do cabeçalho e itens.

Autenticação

Este endpoint requer autenticação via Bearer Token no header Authorization.

Resposta para token inválido:

Status Code: 401 Unauthorized
\n

Response:

        {\n          \"acesso\": \"acesso negado\"\n        }\n\n

Detalhes da Requisição

Método: POST
\n
Endpoint: /v1/pedidovenda/consulta
\n
Content-Type: application/json
\n

Headers Obrigatórios

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Valor	Descrição
Authorization	`{{token}}`	Token de autenticação Bearer

Parâmetros do Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
cnpj	string	Sim	CNPJ (14 dígitos) ou CPF (11 dígitos) do cliente
filial	string	Sim	Código da filial/subsidiária

Exemplo de Requisição

{\n  \"cnpj\": \"32566484600\",\n  \"filial\": \"0101112\"\n}\n\n

Exemplo de Requisição (cURL)

curl --location '{{url_base}}/v1/pedidovenda/consulta' \\\n--header 'Authorization: {{token}}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"cnpj\": \"32566484600\",\n  \"filial\": \"0101112\"\n}'\n\n

Respostas

✅ Sucesso (200 OK)

Retorna um array de pedidos de venda com seus respectivos itens.

{\n  \"pedidos\": [\n    {\n      \"C5_FILIAL\": \"0101112\",\n      \"C5_NUM\": \"001437\",\n      \"C5_CLIENTE\": \"011847\",\n      \"C5_LOJACLI\": \"01\",\n      \"A1_NOME\": \"JOAO LEONARDO VILLELA DA SILVEIRA\",\n      \"C5_EMISSAO\": \"20221207\",\n      \"A1_CGC\": \"32566484600   \",\n      \"ITENS\": [\n        {\n          \"C6_ITEM\": \"01\",\n          \"C6_PRODUTO\": \"04030000024    \",\n          \"B1_DESC\": \"FOX XPRO SC 450 1X20L\",\n          \"C6_QTDVEN\": 140,\n          \"C6_QTDENT\": 0,\n          \"C6_UM\": \"L  \",\n          \"C6_SALDO\": 140\n        },\n        {\n          \"C6_ITEM\": \"02\",\n          \"C6_PRODUTO\": \"04010000008    \",\n          \"B1_DESC\": \"RIDOVER WG 20KG\",\n          \"C6_QTDVEN\": 880,\n          \"C6_QTDENT\": 0,\n          \"C6_UM\": \"KG \",\n          \"C6_SALDO\": 880\n        }\n      ]\n    }\n  ]\n}\n\n

Campos do Pedido (Cabeçalho)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
C5_FILIAL	Código da filial
C5_NUM	Número do pedido de venda
C5_CLIENTE	Código do cliente
C5_LOJACLI	Código da loja do cliente
A1_NOME	Nome completo do cliente
C5_EMISSAO	Data de emissão do pedido (formato AAAAMMDD)
A1_CGC	CNPJ ou CPF do cliente
ITENS	Array contendo os itens do pedido

Campos dos Itens do Pedido

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Descrição
C6_ITEM	Número sequencial do item no pedido
C6_PRODUTO	Código do produto
B1_DESC	Descrição completa do produto
C6_QTDVEN	Quantidade vendida
C6_QTDENT	Quantidade já entregue
C6_UM	Unidade de medida (L, KG, UN, etc.)
C6_SALDO	Saldo restante a entregar (C6_QTDVEN - C6_QTDENT)

❌ Token Inválido (401 Unauthorized)

Retornado quando o token de autenticação é inválido ou está ausente.

{\n  \"acesso\": \"acesso negado\"\n}\n\n

❌ Cliente Não Encontrado

Retornado quando o CNPJ/CPF informado não existe na base de dados ou não possui pedidos.

{\n  \"cnpj\": \"CNPJ/CPF informado está incorreto ou não existe na Base\"\n}\n\n

Variáveis Utilizadas

Este endpoint utiliza as seguintes variáveis de ambiente:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Variável	Descrição	Exemplo
url_base	URL base da API	`https://api.exemplo.com.br`
token	Token de autenticação Bearer	`Bearer eyJhbGc...`

Notas Importantes

⚠️ Campo CNPJ/CPF: O parâmetro cnpj aceita tanto CNPJ (14 dígitos - pessoa jurídica) quanto CPF (11 dígitos - pessoa física). O sistema identifica automaticamente o tipo de documento baseado na quantidade de dígitos.

📋 Múltiplos Pedidos: A resposta pode conter múltiplos pedidos para o mesmo cliente, cada um com seus respectivos itens.

📦 Saldo de Itens: O campo C6_SALDO indica a quantidade ainda não entregue do item. Quando C6_SALDO é igual a C6_QTDVEN, significa que nenhuma entrega foi realizada ainda.

📅 Formato de Data: O campo C5_EMISSAO utiliza o formato AAAAMMDD (exemplo: 20221207 = 07/12/2022).

\n","urlObject":{"path":["v1","pedidovenda","consulta"],"host":["{{url_base}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f37b8317-bab3-48db-91fa-c52cf81d1a03"}]}