{"info":{"_postman_id":"a81f68f0-eca9-4ea7-8b68-5733510df99e","name":"MyTracking","description":"

Documentação da integração padrão do MyTracking para o Tracking 360.

Definições:

API - Web Service com end point no MyTracking, aberto para requisições HTTP que devem ser consumidas pelos clientes, serve para recebimento de informações como os Eventos ou Tarefas (Entregas, Coletas, Etc), ou para que o MyTracking possa receber ocorrências e trackings de outros sistemas.

WEBHOOK - Web Service no qual são disparados requisições HTTP para os clientes, de acordo com a ocorrência de eventos no lado do MyTracking, como por exemplo Tracking e Ocorrências.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"7438099","collectionId":"a81f68f0-eca9-4ea7-8b68-5733510df99e","publishedId":"2s935rKNs9","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2023-02-09T01:04:11.000Z"},"item":[{"name":"Tracking 360","item":[{"name":"API - Criação de Eventos (Entrega, Coleta, Serviços)","id":"3b0ee6e3-4505-410a-a721-6ae6e9437624","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"token","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"eventos\": [\r\n {\r\n \"cnpjCd\": \"99999999999991\",\r\n \"codCd\": \"001\",\r\n \"codCdpai\": \"001\",\r\n \"tipoOpe\": \"1\",\r\n \"agrupadorRota\": \"3054\",\r\n \"numeroManifesto\": \"205060\",\r\n \"dataPrevIniViagem\": \"01/01/2022 08:00\",\r\n \"tipoEvento\": \"\",\r\n \"tipoFrete\": \"\",\r\n \"numeroPedido\": \"282522\",\r\n \"dataPedido\": \"18/04/2022 14:00\",\r\n \"numeroRemessa\": \"151213\",\r\n \"codRastreamentoEcom\": \"\",\r\n \"codSetor\": \"2\",\r\n \"numeroOrdem\": \"123\",\r\n \"serieNfe\": \"001\",\r\n \"numeroNfe\": \"1038707\",\r\n \"dataNfe\": \"11/04/2022 00:00\",\r\n \"chaveNfe\": \"35220455728224000106550010010387071032145773\",\r\n \"serieCte\": \"1\",\r\n \"numeroCte\": \"49612\",\r\n \"dataCte\": \"\",\r\n \"chaveCte\": \"10557282240001061204202206314000100000049612\",\r\n \"valorPedido\": \"60.00\",\r\n \"valorNfe\": \"60.00\",\r\n \"valorEvento\": \"60.00\",\r\n \"valorEventoSip\": \"60.00\",\r\n \"valorFreteEvento\": \"60.00\",\r\n \"obsEvento\": \"Teste de integração\",\r\n \"volumeEvento\": \"50.00\",\r\n \"pesoEvento\": \"100.00\",\r\n \"qtdVolumes\": \"2\",\r\n \"dataPrvEntIni\": \"18/04/2022 14:00\",\r\n \"dataPrvEntFim\": \"19/04/2022 14:00\",\r\n \"dataAgendaIni\": \"19/04/2022 14:00\",\r\n \"dataAgendaFim\": \"20/04/2022 14:00\",\r\n \"leadTime\": \"15\",\r\n \"dataManifesto\": \"18/04/2022 14:00\",\r\n \"tipoCarga\": \"20\",\r\n \"tipoPagamento\": \"\",\r\n \"cnpjCpfDes\": \"05418750860\",\r\n \"inscEstadualDes\": \"\",\r\n \"nomeDes\": \"MARIO ANDRADE\",\r\n \"endDes\": \"RUA TRÊS\",\r\n \"numDes\": \"82\",\r\n \"baiDes\": \"JARDIM BELO\",\r\n \"cidDes\": \"SAO PAULO\",\r\n \"ufDes\": \"SP\",\r\n \"cplDes\": \"\",\r\n \"cepDes\": \"03241010\",\r\n \"siglaPaisDest\": \"\",\r\n \"obsEndDes\": \"\",\r\n \"latitudeEndDes\": \"\",\r\n \"longitudeEndDes\": \"\",\r\n \"telefoneDes\": \"11986372897\",\r\n \"telefoneDes2\": \"\",\r\n \"emailDes\": \"jose@uol.com\",\r\n \"cnpjCpfEmitente\": \"8142803000192\",\r\n \"nomeEmitente\": \"EMPRESA XYZ S/A\",\r\n \"inscEstadualEmitente\": \"\",\r\n \"endEmitente\": \"ALAMEDA MAMORE\",\r\n \"baiEmitente\": \"ALPHAVILLE INDUSTRIAL\",\r\n \"cidEmitente\": \"BARUERI\",\r\n \"ufEmitente\": \"SP\",\r\n \"numEmitente\": \"911\",\r\n \"cplEmitente\": \"SALA 1602\",\r\n \"cepEmitente\": \"06454040\",\r\n \"cnpjTransportadora\": \"9999999999997\",\r\n \"nomeTransportadora\": \"ALPHA PLUS\",\r\n \"inscEstadualTra\": \"\",\r\n \"cpfMotorista\": \"\",\r\n \"nomeMotorista\": \"JOAO CASTRO\",\r\n \"foneMotorista\": \"11986372897\",\r\n \"placaVeiculo\": \"ASG5107\",\r\n \"siglaBaseOrigem\": \"\",\r\n \"siglaBaseDestino\": \"\",\r\n \"criarRoteiroApp\": \"\",\r\n \"enviarRoteirizador\": \"\",\r\n \"codBarras\": \"\",\r\n \"codCor\": \"\",\r\n \"chvProduto\": \"\",\r\n \"delType\": \"\",\r\n \"xmlNfe\": \"\"\r\n }\r\n ]\r\n}"},"url":"{{url}}","description":"

Introdução

A partir dessa API é possivel o envio de eventos de Entregas, Coletas ou Serviços para o MyTracking, podendo ser Pedidos, Remessas, NFes, CTes, ou querlquer outro documento a ser realizado o tracking.

URL e Autenticação

A autenticação é feita a partir de token \"fixo\", enviada no header da requisição.

A URL da API, assim como a o Token deve ser solicitados a equipe de implantação do MyTracking resposnvale pelo cliente.

Campos Obrigátorios

Independente do projeto tipo de operação, Last Mile, Firt Mile, Coleta, Entrega, Embarcador ou Transportador, alguns campos são obrigatórios, segue abaixo:

Chave do Evento: Obrigatório enviar pelo menos uma chave do Evento (Entrega ou Coleta), por exemplo: Pedido, Remessa, NFe ou CTe.

Chave do CD (Unidade, Base): Obrigatório enviar pu o CNPJ ou o Código cadastrado do CD.

Nome do Destinatário: Informar o nome do destinatário.

Observações

Observações sopbre a API

Dicionário de Dados

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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 JSON	Descrição	Exemplo	Tipo Interno	Tam. Max.
cnpjCd	Cnpj do CD	11330500000108	Numérico	14
codCd	Código do CD	1	Numérico	14
codCdpai	Código do CD Pai	35	Alpha Numérico	10
tipoOpe	Tipo de Operação (1-Entrega, 2-Coleta)	35	Alpha Numérico	10
agrupadorRota	Agrupador das Eventos para formação de carga (Manifesto, romaneio, DT Documento de Transporte)	205060	Alpha Numérico	20
numeroManifesto	Número/Código do Manifesto	205060	Alpha Numérico	20
dataManifesto	Data de Emissão do manifesto ou romaneio		Data	10
dataPrevIniViagem	Data/Hora Previsão Inicio da Viagem (Roteiro)		Data/hora	16
tipoEvento	ID do tipo de Evento (lista cadastrada)	1	Numérico	3
tipoFrete	ID do tipo de frete (lista cadastrada)	1	Numérico	3
numeroPedido	Pedido	282522	Numérico	10
dataPedido	Data de emissão do pedido	18/04/2022 14:00	Data/hora	16
numeroRemessa	Remessa	REM151213	Alpha Numérico	20
codRastreamentoEcom	Codigo de rastreamento para ECOMERCE ou AEREO	85432321	Alpha Numérico	20
codSetor	Setor	700	Alpha Numérico	5
numeroOrdem	Numero de Ordem (Usado para quando for uma Coleta)	ORD854125	Alpha Numérico	20
serieNfe	Serie da Nfe	1	Alpha Numérico	3
numeroNfe	Numero da Nfe	1038707	Numérico	10
dataNfe	Data de emissão da Nfe	11/04/2022 00:00	Data/hora	16
chaveNfe	Chave da Nfe	XD3522045572822400010	Alpha Numérico	20
serieCte	Serie do Cte	1	Alpha Numérico	3
numeroCte	Numero do Cte	49612	Numérico	10
dataCte	Data de emissão do CTe	14/04/2022 14:00	Data/hora	16
chaveCte	Chave do Cte	TF105572822400010612042	Alpha Numérico	20
valorPedido	Valor do Pedido	60.00	Numérico	12
valorNfe	Valor da Nota Fiscal	60.00	Numérico	12
valorEvento	Valor do Evento (Valor da Entrega ou Coleta)	60.00	Numérico	12
valorEventoSip	Valor do Frete sem Impostos	60.00	Numérico	12
valorFreteEvento	Valor do Frete	60.00	Numérico	12
obsEvento	Observação de Evento	ENTREGAR NA PORTARIA	Alpha Numérico	20
volumeEvento	Volume em m³	50.00	Numérico	12
pesoEvento	Peso em KG	100.00	Numérico	12
qtdVolumes	Qtd. De Volumes	2	Numérico	6
dataPrvEntIni	Data Previsão de Evento (Janela Inicio)	18/04/2022 13:00	Data/hora	16
dataPrvEntFim	Data Previsão de Evento (Janela Fim)	19/04/2022 19:00	Data/hora	16
dataAgendaIni	Data agendamento de Evento (Janela Inicio)	19/04/2022	Data/hora	16
dataAgendaFim	Data agendamento de Evento (Janela Fim)	20/04/2022	Data/hora	16
leadTime	Lead time de Evento	15	Numérico	2
dataManifesto	Data do Manifesto	18/04/2022	Data/hora	16
tipoCarga	Código do Tipo de Carga	20	Alpha Numérico	10
tipoPagamento	Código do Tipo de Pagamento	20	Alpha Numérico	10
cnpjCpfDes	CNPJ ou CPF do destinatario	5418750	Numérico	8
inscEstadualDes	Inscrição Estadual do Destinatario	253568798	Numérico	9
nomeDes	Nome	MARIO ANDRADE	Alpha Numérico	100
endDes	Endereço	RUA TRÊS	Alpha Numérico	100
numDes	Numero	82	Alpha Numérico	20
baiDes	Bairro	JARDIM BELO	Alpha Numérico	100
cidDes	Cidade	SAO PAULO	Alpha Numérico	100
ufDes	UF	SP	Alpha Numérico	2
cplDes	Complemento	SALA 25	Alpha Numérico	40
cepDes	CEP	3241010	Numérico	9
siglaPaisDest	Sigla do Pais (se não enviar é considerador BR)	BR	Alpha Numérico	2
obsEndDes	Observação do Endereço	TOCAR A CAMPAINHA	Alpha Numérico	100
latitudeEndDes	Latitude	-2.526214	Numérico	10
longitudeEndDes	Longitude	-4.659887	Numérico	10
telefoneDes	Telefone Principal	11999999999	Numérico	11
telefoneDes2	Telefone Secundario	11999999999	Numérico	11
emailDes	Email	jose@uol.com	Alpha Numérico	100
cnpjCpfEmitente	Cnpj do Emitente (embarcador)	1E+14	Numérico	14
nomeEmitente	Nome Emitente	EMPRESA XYZ S/A	Alpha Numérico	100
inscEstadualEmitente	Inscrição Estadual do Emitente (embarcador)	253568798	Numérico	9
endEmitente	Endereço	ALAMEDA MAMORÉ	Alpha Numérico	100
baiEmitente	Bairro	ALPHAVILLE INDUSTRIAL	Alpha Numérico	100
cidEmitente	Cidade	BARUERI	Alpha Numérico	100
ufEmitente	UF	SP	Alpha Numérico	2
numEmitente	Numero	911	Alpha Numérico	20
cplEmitente	Complemento	SALA 1602	Alpha Numérico	40
cepEmitente	CEP	6454040	Numérico	9
cnpjTransportadora	CNPJ da Transportadora	1E+14	Numérico	14
nomeTransportadora	Nome da Transportadora	ALPHA PLUS	Alpha Numérico	100
inscEstadualTra	Inscrição Estadual	253568798	Numérico	9
cpfMotorista	CPF do Motorista	25822512345	Numérico	11
nomeMotorista	Nome do Motorista	JOSE AMORIM	Alpha Numérico	100
foneMotorista	Telefone do Motorista	1,2E+11	Numérico	11
placaVeiculo	Placa do Veículo	ASG5107	Alpha Numérico	7
siglaBaseOrigem	Sigla da Base de Origem (ex.: CGH)	CGH	Alpha Numérico	5
siglaBaseDestino	Sigla da Base de Destino (ex.: REC)	REC	Alpha Numérico	5
criarRoteiroApp	Criar Roteiro APP: 0-\"Não Cria\", 1-Criar via \"agrupadorRota\", 2-Criar via \"numeroManifesto\"	0	Numérico	5
enviarRoteirizador	Enviar Roteirização: 0-Não enviar, 1-Enviar	0	Numérico
codBarras	Código de Barras para localização do Evento	12345689	Numérico	30
codCor	Código da Cor para o ponto no Mapa – Tabela Interna (utilizado no Roteirizador)	1	Numérico	2
chvProduto	Chave do Produto padrão para o Evento		Alpha Numérico	5
delType	Delivery Type (código interno AVON, Latam, Etc)		Alpha Numérico	50
xmlNfe	Conteúdo integral da NF-e no layout 4.00, incluindo tags , e . Deve conter o XML autorizado conforme schema oficial da SEFAZ.	`...`	Texto (XML)	-

API de envio de eventos para o MyTracking

\n","urlObject":{"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3b0ee6e3-4505-410a-a721-6ae6e9437624"},{"name":"WEBHOOK - Envio de Trackings (Status ou Ocorrências)","id":"625bca90-b4a4-460e-8392-6bd665ff9058","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"token","value":"informar_token_fornecido_pela_equipe","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"eventos\": [\r\n {\r\n \"placaVeiculo\": \"XAS5412\",\r\n \"cpfMotorista\": \"14525214599\",\r\n \"numeroOrdem\": \"XASE1345678\",\r\n \"serieCte\": \"B\",\r\n \"numeroCte\": \"123456\",\r\n \"chaveCte\": \"TF5464132133213132154654DS\",\r\n \"codOcorrencia\": \"1\",\r\n \"descOcorrencia\": \"Entrega Realizada\",\r\n \"datahoraOcorrencia\": \"01/01/2022 13:00\",\r\n \"nomeRecebedor\": \"JOSE\",\r\n \"chaveNfeColeta\": \"5214201542154212541542156421542154;5463546546545421321354584543;\",\r\n \"linkPod\": \"https://app.link./juhstg;\"\r\n }\r\n ]\r\n}"},"url":"https://url.webhook/myroute/service/dynamicjson1/","description":"

Introdução

A partir desse WEBHOOK, o MyTracking pode enviar para o cliente trackings e ocorrências de uma Entrega ou Coleta como por exemplo \"Entrega Chegou no CD\", \"Entrega em Rota\", \"Entrega Realizada\", Entrga Não Realizada\".

URL e Autenticação

A autenticação é feita a partir de token \"fixo\", enviada no header da requisição.

Alterar a \"url.webhook\" pela URL enviada pela equipe de TI do Cliente.

A URL da API, assim como a o Token deve ser solicitados a equipe de TI cliente.

Campos Obrigátorios

Informações sobre campos Obrigatórios.

Observações

Observações sopbre o WEBHOOK

Dicionário de Dados

Campo JSON	Descrição	Exemplo	Tipo	Tam. Max.
placaVeiculo	Placa do Veículo	PCX5214	Alpha Numérico	10
cpfMotorista	CPF do Motorista	251521453	Numérico	14
numeroOrdem	Numero da Ordemd e Coleta	55215d1f	Alpha Numérico	20
numeroRemessa	Remessa		Alpha Numérico	20
numeroPedido	Pedido		Numérico	20
serieCte	Serie do CTE	1	Alpha Numérico	10
numeroCte	Numero do Cte	12354	Numérico	20
chaveCte	Chave do CTE		Alpha Numérico	100
serieNfe	Série NFe		Alpha Numérico	10
numeroNfe	Número Ne		Númerico	20
chaveNfe	Chave NFe		Alpha Numérico	100
codOcorrencia	ID da Ocorrência	1	Alpha Numérico	10
descOcorrencia	Descrição da Ocorrência	Entrega Realizada	Alpha Numérico	100
datahoraOcorrencia	Data/Hora que a Ocorrência foi realizada	01/01/2022 16:24	Numérico	2
nomeRecebedor	Nome do Recebedor informado no APP	JOSE	Alpha Numérico	100
codBarras	Cod. Barras lidos no APP, podendo ser etiquetas, notas fiscais, etc. No caso de mais de um código,será separado por \";\"	89550318003317218443;89550318003317218823	Alpha Numérico	500
linkPod	Link com a imagem do POD. Pode ser enviados varios, separados por “;”		Alpha Numérico	100

WebHook de envio de retorno de eventos para o Cliente

\n","urlObject":{"protocol":"https","path":["myroute","service","dynamicjson1",""],"host":["url","webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"625bca90-b4a4-460e-8392-6bd665ff9058"},{"name":"API - Buscar Rotas (Roteirização)","id":"c682d32d-966e-46fe-8bfa-1b5551c347c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"buscaRotas\": [\r\n {\r\n \"cnpjCd\": \"24949232004177\",\r\n \"dataRota\": \"10/04/2025\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}","description":"

📘 API - Busca de Rotas (Rascunho)

🔹 Introdução

Essa API permite consultar rotas criadas no módulo de roteirização da plataforma MyTracking, que ainda estão em status de rascunho, ou seja, não liberadas para execução.

Ela retorna os eventos associados às entregas ou coletas previstas para o dia, incluindo:

Número da Rota
\n
ID da Entrega
\n
CNPJ/CPF e Nome do Destinatário
\n
Pedido, Remessa, Nota Fiscal
\n
Informações logísticas e status de retorno
\n

\n
Indicado para: validações de planejamento, auditorias internas ou integrações com sistemas externos de gestão e monitoramento.
\n

🔐 Autenticação

A autenticação é feita por meio de Token Fixo, enviado no header da requisição HTTP:

\n
A URL da API e o token devem ser solicitados à equipe técnica da MyTracking.
\n

📥 Exemplo de Requisição

{\n  \"buscaRotas\": [\n    {\n      \"cnpjCd\": \"24949232004146\",\n      \"dataRota\": \"10/04/2025\"\n    }\n  ]\n}\n\n

✅ Campos Obrigatórios da Requisição

\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	Tipo	Tamanho Máx
`cnpjCd`	CNPJ do Centro de Distribuição	Numérico	14
`dataRota`	Data da Rota (formato DD/MM/AAAA)	Texto	10

📤 Exemplo de Resposta

{\n  \"rotas_eventos\": [\n    {\n      \"cnpjCd\": \"24949232004146\",\n      \"dataRota\": \"10/04/2025\",\n      \"numeroRota\": \"13621\",\n      \"cpfMotorista\": \"\",\n      \"nomeMotorista\": \"\",\n      \"placaVeiculo\": \"\",\n      \"cnpjCpfDes\": \"11825624000164\",\n      \"nomeDes\": \"T DX PIZZARIA LTDA - ME\",\n      \"seqEvento\": \"1\",\n      \"idEntrega\": \"106788\",\n      \"numeroPedido\": \"\",\n      \"numerooRemessa\": \"ACJUIH\",\n      \"numeroNfe\": \"1930096\",\n      \"numeroCte\": \"\",\n      \"numeroOrdem\": \"ACJUIH\",\n      \"numeroManifesto\": \"00242333\",\n      \"codRetorno\": \"1\",\n      \"msgRetorno\": \"ok\"\n    }\n  ]\n}\n\n

📚 Dicionário de Dados da Resposta

Campo JSON	Descrição	Exemplo	Tipo Interno	Tam. Max.
cnpjCd	CNPJ do Centro de Distribuição	24949232004146	Numérico	14
dataRota	Data da Rota	10/04/2025	Texto	10
numeroRota	Número da Rota	13621	Texto	10
cpfMotorista	CPF do Motorista	12345678900	Numérico	14
nomeMotorista	Nome do Motorista	João da Silva	Texto	100
placaVeiculo	Placa do Veículo	ABC1D23	Texto	10
cnpjCpfDes	CNPJ ou CPF do Destinatário	11825624000164	Texto	14
nomeDes	Nome do Destinatário	PIZZARIA XYZ LTDA	Texto	100
seqEvento	Sequência do Evento	1	Texto	10
idEntrega	ID interno da Entrega	106788	Texto	10
numeroPedido	Número do Pedido	PED12345	Texto	20
numerooRemessa	Número da Remessa	ACJUIH	Texto	20
numeroNfe	Número da Nota Fiscal	1930096	Texto	20
numeroCte	Número do CTe	1234567	Texto	20
numeroOrdem	Número da Ordem	ORD98765	Texto	20
numeroManifesto	Número do Manifesto	00242333	Texto	20
codRetorno	Código de retorno da operação	1	Texto	2
msgRetorno	Mensagem descritiva do retorno	ok	Texto	100

Observações

Apenas rotas em status de rascunho são retornadas por esta API.
\n
Campos como cpfMotorista, placaVeiculo e numeroCte poderão vir vazios até a liberação da rota.
\n
Cada rota pode conter múltiplos eventos, ordenados por seqEvento.
\n
O campo codRetorno igual a \"1\" indica sucesso na recuperação da informação.
\n

\n","urlObject":{"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c682d32d-966e-46fe-8bfa-1b5551c347c8"},{"name":"API – Consulta Transportadora","id":"10fab3ea-8558-448e-916c-4e5a364964c2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"consulta\": [\r\n {\r\n \"cnpjEmbarcador\": \"59970624000265\",\r\n \"ufOrigem\": \"SP\",\r\n \"cepOrigem\": \"06454000\",\r\n \"ufDestino\": \"SP\",\r\n \"cepDestino\": \"05454000\",\r\n \"numeroPedido\": \"123\",\r\n \"valorEvento\": \"2150.32\",\r\n \"pesoEvento\": \"5.00\",\r\n \"volumeEvento\": \"0.03\",\r\n \"qtdVolumes\": \"2.00\",\r\n \"tipoEvento\": \"1\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}","description":"

📘 API – Consulta de Melhor Transportadora

🔹 Introdução

Essa API permite identificar a melhor transportadora para uma entrega, com base nas tabelas e regras configuradas para o embarcador dentro da plataforma MyTracking.

A consulta é realizada via payload consulta, contendo os dados logísticos e comerciais necessários para cálculo do frete e prazo.
O retorno traz a transportadora mais vantajosa (por custo, prazo ou ambos) e as informações de retorno padronizadas.

Endpoint: https://app.mytracking.com.br/myroute/service/dynamicjson1
\n
Versão: v1
\n
Formato: application/json
\n

🔐 Autenticação

A autenticação é feita por meio de Token Fixo, enviado no header da requisição HTTP:

Authorization: <token>\n\n

\n
O token e o endpoint devem ser solicitados à equipe técnica da MyTracking.
\n

📥 Exemplo de Requisição

{\n  \"consulta\": [\n    {\n      \"cnpjEmbarcador\": \"59970624000265\",\n      \"nomeDes\": \"MARIO ANDRADE\",\n      \"cnpjCpfDes\": \"11330500000108\",\n      \"ufOrigem\": \"SP\",\n      \"cepOrigem\": \"06454000\",\n      \"ufDestino\": \"SP\",\n      \"cepDestino\": \"05454000\",\n      \"numeroPedido\": \"123\",\n      \"valorPedido\": \"2150.32\",\n      \"pesoPedido\": \"5.00\",\n      \"volumePedido\": \"0.03\",\n      \"qtdVolumes\": \"2.00\",\n      \"tipoEvento\": \"1\"\n    }\n  ]\n}\n\n

✅ Campos Obrigatórios da Requisição

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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	Tipo	Formato/Tamanho
`cnpjEmbarcador`	CNPJ do embarcador (define as tabelas e regras)	Numérico (string)	14 dígitos
`ufOrigem`	UF de origem	Texto	2 letras (A–Z)
`cepOrigem`	CEP de origem	Numérico (string)	8 dígitos
`ufDestino`	UF de destino	Texto	2 letras (A–Z)
`cepDestino`	CEP de destino	Numérico (string)	8 dígitos
`numeroPedido`	Identificador do pedido	Texto	até 100
`valorEvento`	Valor declarado da entrega (R$)	Numérico (string)	ponto decimal (`\"10.00\"`)
`pesoEvento`	Peso total da entrega (kg)	Numérico (string)	ponto decimal
`volumeEvento`	Volume total (m³)	Numérico (string)	ponto decimal
`qtdVolumes`	Quantidade de volumes	Numérico (string)	inteiro em string (ex. `\"2\"` ou `\"2.00\"`)
`tipoEvento`	Tipo do serviço	Texto	`\"1\"` = Expresso / `\"2\"` = Convencional

🧩 Campos Opcionais

\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	Tipo	Tamanho
`nomeDes`	Nome do destinatário	Texto	100
`cnpjCpfDes`	CPF/CNPJ do destinatário	Numérico (string)	11 (CPF) / 14 (CNPJ)

\n
Todos os valores numéricos devem vir como string, utilizando ponto (.) como separador decimal.
O campo consulta pode conter N itens, e o array resultado retornará na mesma ordem.
\n

📤 Exemplo de Resposta (Sucesso)

{\n  \"resultado\": [\n    {\n      \"cnpjTransportadora\": \"18903588000121\",\n      \"nomeTransportadora\": \"XPTO LOGÍSTICA LTDA\",\n      \"valFrete\": \"193.21\",\n      \"leadTime\": \"2\",\n      \"numeroPedido\": \"123\",\n      \"codRetorno\": \"1\",\n      \"msgRetorno\": \"OK\"\n    }\n  ]\n}\n\n

📚 Dicionário de Dados 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 JSON	Descrição	Exemplo	Tipo Interno	Tam. Máx.
`cnpjTransportadora`	CNPJ da transportadora selecionada	18903588000121	Numérico (string)	14
`nomeTransportadora`	Nome da transportadora	XPTO LOGÍSTICA LTDA	Texto	150
`valFrete`	Valor total do frete (R$)	193.21	Numérico (string)	—
`leadTime`	Prazo estimado (dias úteis)	2	Texto	3
`numeroPedido`	Identificador ecoado do pedido	123	Texto	100
`cod_retorno`	Código de retorno	1	Texto	2
`msg_retorno`	Mensagem de retorno	OK	Texto	100

🔁 Códigos de Retorno

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

Código	Significado	Descrição
`\"1\"`	Sucesso	Opção encontrada e calculada
`\"0\"`	Erro de negócio/validação	Campo inválido ou nenhuma transportadora elegível
`\"9\"`	Erro interno	Falha inesperada no processamento

🧪 Exemplos de Retorno

✅ Sucesso (200)

{\n  \"resultado\": [\n    {\n      \"cnpjTransportadora\": \"18903588000121\",\n      \"nomeTransportadora\": \"XPTO LOGÍSTICA LTDA\",\n      \"valFrete\": \"193.21\",\n      \"leadTime\": \"2\",\n      \"numeroPedido\": \"123\",\n      \"codRetorno\": \"1\",\n      \"msgRetorno\": \"OK\"\n    }\n  ]\n}\n\n

⚠️ Nenhuma elegível (200)

{\n  \"resultado\": [\n    {\n      \"numeroPedido\": \"123\",\n      \"codRetorno\": \"0\",\n      \"msgRetorno\": \"Nenhuma transportadora elegível\"\n    }\n  ]\n}\n\n

❌ Erro de Validação (400)

{\n  \"resultado\": [\n    {\n      \"numeroPedido\": \"123\",\n      \"codRetorno\": \"0\",\n      \"msgRetorno\": \"Campos inválidos: cepOrigem, tipoEvento\"\n    }\n  ]\n}\n\n

🚨 Erro Interno (500)

{\n  \"resultado\": [\n    {\n      \"numeroPedido\": \"123\",\n      \"codRetorno\": \"9\",\n      \"msgRetorno\": \"Erro interno. Tente novamente mais tarde.\"\n    }\n  ]\n}\n\n

📋 Regras e Observações

A seleção da transportadora é baseada nas tabelas configuradas para o embarcador (cnpjEmbarcador), considerando faixas de peso, volume, valores mínimos, adicionais e zonas de CEP.
\n
O array resultado mantém a mesma sequência dos itens enviados em consulta.
\n
Caso faltem campos obrigatórios, retornar HTTP 400 com cod_retorno: \"0\".
\n
Falhas inesperadas devem retornar HTTP 500 com cod_retorno: \"9\".
\n
Campos de autenticação ausentes retornam 401, e tokens inválidos/expirados retornam 403.
\n

⚙️ Limites e Boas Práticas

Rate Limit: até 60 requisições/minuto por cnpjEmbarcador.
\n
Tamanho máximo do payload: 1 MB.
\n
Boas práticas:
\n
- Utilize numeroPedido como chave única por consulta.
  \n
- Evite valores nulos ou campos vazios.
  \n
- Envie todos os campos numéricos como string com ponto decimal.
  \n
\n

\n","urlObject":{"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"10fab3ea-8558-448e-916c-4e5a364964c2"}],"id":"acab255b-2245-4f98-8c19-5a5f04fc7c9b","_postman_id":"acab255b-2245-4f98-8c19-5a5f04fc7c9b","description":""},{"name":"Links","item":[],"id":"f08a95da-f2dd-472a-b353-0d057a5c4a1d","_postman_id":"f08a95da-f2dd-472a-b353-0d057a5c4a1d","description":""},{"name":"Widgets","item":[],"id":"0fcf66be-1f57-4690-872a-755beee2e73f","_postman_id":"0fcf66be-1f57-4690-872a-755beee2e73f","description":""},{"name":"Conferência","item":[],"id":"29fa8bb6-623e-41fa-8b6e-24cc5856b1ca","_postman_id":"29fa8bb6-623e-41fa-8b6e-24cc5856b1ca","description":""},{"name":"NT_AB","item":[{"name":"API - Criação de Eventos (Entrega, Coleta, Serviços) NT_AB","id":"ae3cd97e-ccd4-4df1-a1f6-eb839477d5f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"token","value":"{{token}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"eventos\": [\r\n\t\t{\r\n\t\t\t\"cnpjCd\": \"99999999999991\",\r\n\t\t\t\"codCd\": \"1\",\r\n\t\t\t\"codCdpai\": \"35\",\r\n\t\t\t\"tipoOpe\": \"1\",\r\n\t\t\t\"agrupadorRota\": \"205060\",\r\n\t\t\t\"numeroManifesto\": \"205060\",\r\n\t\t\t\"dataManifesto\": \"01/01/2022\",\r\n\t\t\t\"dataPrevIniViagem\": \"01/01/2022 08:00\",\r\n\t\t\t\"tipoEvento\": \"1\",\r\n\t\t\t\"tipoFrete\": \"1\",\r\n\t\t\t\"numeroPedido\": \"282522\",\r\n\t\t\t\"dataPedido\": \"18/04/2022 14:00\",\r\n\t\t\t\"numeroRemessa\": \"REM151213\",\r\n\t\t\t\"codRastreamentoEcom\": \"85432321\",\r\n\t\t\t\"codSetor\": \"700\",\r\n\t\t\t\"numeroOrdem\": \"ORD854125\",\r\n\t\t\t\"serieNfe\": \"1\",\r\n\t\t\t\"numeroNfe\": \"1038707\",\r\n\t\t\t\"dataNfe\": \"11/04/2022 00:00\",\r\n\t\t\t\"chaveNfe\": \"XD3522045572822400010\",\r\n\t\t\t\"serieCte\": \"1\",\r\n\t\t\t\"numeroCte\": \"49612\",\r\n\t\t\t\"dataCte\": \"14/04/2022 14:00\",\r\n\t\t\t\"chaveCte\": \"TF105572822400010612042\",\r\n\t\t\t\"valorPedido\": \"60.00\",\r\n\t\t\t\"valorNfe\": \"60.00\",\r\n\t\t\t\"valorEvento\": \"60.00\",\r\n\t\t\t\"valorEventoSip\": \"60.00\",\r\n\t\t\t\"valorFreteEvento\": \"60.00\",\r\n\t\t\t\"obsEvento\": \"ENTREGAR NA PORTARIA\",\r\n\t\t\t\"volumeEvento\": \"50.00\",\r\n\t\t\t\"tamanhoCaixa\": \"003\",\r\n\t\t\t\"pesoEvento\": \"100.00\",\r\n\t\t\t\"qtdVolumes\": \"2\",\r\n\t\t\t\"dataPrvEntIni\": \"18/04/2022 13:00\",\r\n\t\t\t\"dataPrvEntFim\": \"19/04/2022 19:00\",\r\n\t\t\t\"dataAgendaIni\": \"19/04/2022 14:00\",\r\n\t\t\t\"dataAgendaFim\": \"20/04/2022 14:00\",\r\n\t\t\t\"leadTime\": \"15\",\r\n\t\t\t\"tipoCarga\": \"20\",\r\n\t\t\t\"tipoPagamento\": \"20\",\r\n\t\t\t\"cnpjCpfDes\": \"5418750\",\r\n\t\t\t\"inscEstadualDes\": \"253568798\",\r\n\t\t\t\"nomeDes\": \"MARIO ANDRADE\",\r\n\t\t\t\"endDes\": \"RUA TRÊS\",\r\n\t\t\t\"numDes\": \"82\",\r\n\t\t\t\"baiDes\": \"JARDIM BELO\",\r\n\t\t\t\"cidDes\": \"SAO PAULO\",\r\n\t\t\t\"ufDes\": \"SP\",\r\n\t\t\t\"cplDes\": \"SALA 25\",\r\n\t\t\t\"cepDes\": \"3241010\",\r\n\t\t\t\"siglaPaisDest\": \"BR\",\r\n\t\t\t\"obsEndDes\": \"TOCAR A CAMPAINHA\",\r\n\t\t\t\"latitudeEndDes\": \"-2.526214\",\r\n\t\t\t\"longitudeEndDes\": \"-4.659887\",\r\n\t\t\t\"telefoneDes\": \"11999999999\",\r\n\t\t\t\"telefoneDes2\": \"11999999999\",\r\n\t\t\t\"emailDes\": \"jose@uol.com\",\r\n\t\t\t\"cnpjCpfEmitente\": \"1E+14\",\r\n\t\t\t\"nomeEmitente\": \"EMPRESA XYZ S/A\",\r\n\t\t\t\"inscEstadualEmitente\": \"253568798\",\r\n\t\t\t\"endEmitente\": \"ALAMEDA MAMORÉ\",\r\n\t\t\t\"baiEmitente\": \"ALPHAVILLE INDUSTRIAL\",\r\n\t\t\t\"cidEmitente\": \"BARUERI\",\r\n\t\t\t\"ufEmitente\": \"SP\",\r\n\t\t\t\"numEmitente\": \"911\",\r\n\t\t\t\"cplEmitente\": \"SALA 1602\",\r\n\t\t\t\"cepEmitente\": \"6454040\",\r\n\t\t\t\"cnpjTransportadora\": \"1E+14\",\r\n\t\t\t\"nomeTransportadora\": \"ALPHA PLUS\",\r\n\t\t\t\"inscEstadualTra\": \"253568798\",\r\n\t\t\t\"cpfMotorista\": \"25822512345\",\r\n\t\t\t\"nomeMotorista\": \"JOSE AMORIM\",\r\n\t\t\t\"foneMotorista\": \"11999999999\",\r\n\t\t\t\"placaVeiculo\": \"ASG5107\",\r\n\t\t\t\"siglaBaseOrigem\": \"CGH\",\r\n\t\t\t\"siglaBaseDestino\": \"REC\",\r\n\t\t\t\"criarRoteiroApp\": \"0\",\r\n\t\t\t\"enviarRoteirizador\": \"0\",\r\n\t\t\t\"codBarras\": \"12345689\",\r\n\t\t\t\"codCor\": \"1\",\r\n\t\t\t\"chvProduto\": \"P12345\",\r\n\t\t\t\"delType\": \"AVON\",\r\n\t\t\t\"codIbgeMunicipio\": \"3550308\",\r\n\t\t\t\"codRota\": \"ROTA123\",\r\n\t\t\t\"codSubRota\": \"SUBROTA1\",\r\n\t\t\t\"seqRota\": \"3\",\r\n\t\t\t\"contatosAux\": \"C123\",\r\n\t\t\t\"ideNfe\": \"123456\",\r\n\t\t\t\"codModalidadeEnt\": \"1\",\r\n\t\t\t\"codTurno\": \"2\",\r\n\t\t\t\"codTipoPedido\": \"10\",\r\n\t\t\t\"codGrauRisco\": \"2\",\r\n\t\t\t\"codVen\": \"98765\",\r\n\t\t\t\"numDt1\": \"12345678901\",\r\n\t\t\t\"numDt2\": \"12345678902\",\r\n\t\t\t\"codTransp\": \"T1234\",\r\n\t\t\t\"codTransp2\": \"T567\"\r\n\t\t}\r\n\t]\r\n}"},"url":"{{url}}","description":"

Introdução

URL e Autenticação

A autenticação é feita a partir de token \"fixo\", enviada no header da requisição.

A URL da API, assim como a o Token deve ser solicitados a equipe de implantação do MyTracking resposnvale pelo cliente.

Campos Obrigátorios

Independente do projeto tipo de operação, Last Mile, Firt Mile, Coleta, Entrega, Embarcador ou Transportador, alguns campos são obrigatórios, segue abaixo:

Chave do Evento: Obrigatório enviar pelo menos uma chave do Evento (Entrega ou Coleta), por exemplo: Pedido, Remessa, NFe ou CTe.

Chave do CD (Unidade, Base): Obrigatório enviar pu o CNPJ ou o Código cadastrado do CD.

Nome do Destinatário: Informar o nome do destinatário.

Observações

Observações sobre a API

Rate limiting

-O tamanho de pacote máximo deve ser de 20 registros e 200 kb
-Requisições 1 requisição a cada 5 segundos
-O tempo de resposta nosso deve ser de no máximo 30s

Dicionário de Dados

Campo JSON	NT_NOTFIS	Descrição	Exemplo	Tipo Interno	Tam. Max.
cnpjCd	S	Cnpj do CD	11330500000108	Numérico	14
codCd	N	Código do CD	1	Numérico	14
codCdpai	N	Código do CD Pai	35	Alpha Numérico	10
tipoOpe	N	Tipo de Operação (1-Entrega, 2-Coleta)	35	Alpha Numérico	10
agrupadorRota	N	Agrupador das Eventos para formação de carga (Manifesto, romaneio, DT Documento de Transporte)	205060	Alpha Numérico	20
numeroManifesto	S	Número/Código do Manifesto	205060	Alpha Numérico	20
dataManifesto	S	Data de Emissão do manifesto ou romaneio		Data	10
dataPrevIniViagem	N	Data/Hora Previsão Inicio da Viagem (Roteiro)		Data/hora	16
tipoEvento	S	ID do tipo de Evento (lista cadastrada)	1	Numérico	3
tipoFrete	N	ID do tipo de frete (lista cadastrada)	1	Numérico	3
numeroPedido	S	Pedido	282522	Numérico	10
dataPedido	S	Data de emissão do pedido	18/04/2022 14:00	Data/hora	16
numeroRemessa	S	Remessa	REM151213	Alpha Numérico	20
codRastreamentoEcom	N	Codigo de rastreamento para ECOMERCE ou AEREO	85432321	Alpha Numérico	20
codSetor	S	Setor	700	Alpha Numérico	5
numeroOrdem	N	Numero de Ordem (Usado para quando for uma Coleta)	ORD854125	Alpha Numérico	20
serieNfe	S	Serie da Nfe	1	Alpha Numérico	3
numeroNfe	S	Numero da Nfe	1038707	Numérico	10
dataNfe	S	Data de emissão da Nfe	11/04/2022 00:00	Data/hora	16
chaveNfe	S	Chave da Nfe	XD3522045572822400010	Alpha Numérico	20
serieCte	N	Serie do Cte	1	Alpha Numérico	3
numeroCte	N	Numero do Cte	49612	Numérico	10
dataCte	N	Data de emissão do CTe	14/04/2022 14:00	Data/hora	16
chaveCte	N	Chave do Cte	TF105572822400010612042	Alpha Numérico	20
valorPedido	N	Valor do Pedido	60.00	Numérico	12
valorNfe	S	Valor da Nota Fiscal	60.00	Numérico	12
valorEvento	N	Valor do Evento (Valor da Entrega ou Coleta)	60.00	Numérico	12
valorEventoSip	N	Valor do Frete sem Impostos	60.00	Numérico	12
valorFreteEvento	S	Valor do Frete	60.00	Numérico	12
obsEvento	S	Observação de Evento	ENTREGAR NA PORTARIA	Alpha Numérico	20
volumeEvento	S	Volume em m³	50.00	Numérico	12
tamanhoCaixa	S	Tamanho da caixa	003	Alpha Numérico	12
pesoEvento	S	Peso em KG	100.00	Numérico	12
qtdVolumes	S	Qtd. De Volumes	2	Numérico	6
dataPrvEntIni	S	Data Previsão de Evento (Janela Inicio)	18/04/2022 13:00	Data/hora	16
dataPrvEntFim	S	Data Previsão de Evento (Janela Fim)	19/04/2022 19:00	Data/hora	16
dataAgendaIni	N	Data agendamento de Evento (Janela Inicio)	19/04/2022	Data/hora	16
dataAgendaFim	N	Data agendamento de Evento (Janela Fim)	20/04/2022	Data/hora	16
leadTime	N	Lead time de Evento	15	Numérico	2
dataManifesto	S	Data do Manifesto	18/04/2022	Data/hora	16
tipoCarga	N	Código do Tipo de Carga	20	Alpha Numérico	10
tipoPagamento	N	Código do Tipo de Pagamento	20	Alpha Numérico	10
cnpjCpfDes	S	CNPJ ou CPF do destinatario	5418750	Numérico	8
inscEstadualDes	S	Inscrição Estadual do Destinatario	253568798	Numérico	9
nomeDes	S	Nome	MARIO ANDRADE	Alpha Numérico	100
endDes	S	Endereço	RUA TRÊS	Alpha Numérico	100
numDes	S	Numero	82	Alpha Numérico	20
baiDes	S	Bairro	JARDIM BELO	Alpha Numérico	100
cidDes	S	Cidade	SAO PAULO	Alpha Numérico	100
ufDes	S	UF	SP	Alpha Numérico	2
cplDes	S	Complemento	SALA 25	Alpha Numérico	40
cepDes	S	CEP	3241010	Numérico	9
siglaPaisDest	N	Sigla do Pais (se não enviar é considerador BR)	BR	Alpha Numérico	2
obsEndDes	S	Observação do Endereço	TOCAR A CAMPAINHA	Alpha Numérico	100
latitudeEndDes	S	Latitude	-2.526214	Numérico	10
longitudeEndDes	S	Longitude	-4.659887	Numérico	10
telefoneDes	S	Telefone Principal	11999999999	Numérico	11
telefoneDes2	N	Telefone Secundario	11999999999	Numérico	11
emailDes	S	Email	jose@uol.com	Alpha Numérico	100
cnpjCpfEmitente	S	Cnpj do Emitente (embarcador)	1E+14	Numérico	14
nomeEmitente	S	Nome Emitente	EMPRESA XYZ S/A	Alpha Numérico	100
inscEstadualEmitente	S	Inscrição Estadual do Emitente (embarcador)	253568798	Numérico	9
endEmitente	S	Endereço	ALAMEDA MAMORÉ	Alpha Numérico	100
baiEmitente	S	Bairro	ALPHAVILLE INDUSTRIAL	Alpha Numérico	100
cidEmitente	S	Cidade	BARUERI	Alpha Numérico	100
ufEmitente	S	UF	SP	Alpha Numérico	2
numEmitente	S	Numero	911	Alpha Numérico	20
cplEmitente	S	Complemento	SALA 1602	Alpha Numérico	40
cepEmitente	S	CEP	6454040	Numérico	9
cnpjTransportadora	S	CNPJ da Transportadora	1E+14	Numérico	14
nomeTransportadora	S	Nome da Transportadora	ALPHA PLUS	Alpha Numérico	100
inscEstadualTra	S	Inscrição Estadual	253568798	Numérico	9
cpfMotorista	N	CPF do Motorista	25822512345	Numérico	11
nomeMotorista	N	Nome do Motorista	JOSE AMORIM	Alpha Numérico	100
foneMotorista	N	Telefone do Motorista	1,2E+11	Numérico	11
placaVeiculo	N	Placa do Veículo	ASG5107	Alpha Numérico	7
siglaBaseOrigem	N	Sigla da Base de Origem (ex.: CGH)	CGH	Alpha Numérico	5
siglaBaseDestino	N	Sigla da Base de Destino (ex.: REC)	REC	Alpha Numérico	5
criarRoteiroApp	N	Criar Roteiro APP: 0-\"Não Cria\", 1-Criar via \"agrupadorRota\", 2-Criar via \"numeroManifesto\"	0	Numérico	5
enviarRoteirizador	N	Enviar Roteirização: 0-Não enviar, 1-Enviar	0	Numérico
codBarras	N	Código de Barras para localização do Evento	12345689	Numérico	30
codCor	N	Código da Cor para o ponto no Mapa – Tabela Interna (utilizado no Roteirizador)	1	Numérico	2
chvProduto	N	Chave do Produto padrão para o Evento	P12345	Alpha Numérico	5
delType	N	Delivery Type (código interno AVON, Latam, Etc)	AVON	Alpha Numérico	50
codIbgeMunicipio	S	Código do Município IBGE	3550308	Alpha Numérico	10
codRota	S	Rota	ROTA123	Alpha Numérico	20
codSubRota	S	Sub Rota	SUBROTA1	Alpha Numérico	20
seqRota	N	Sequencia da Entrega na Rota	3	Numérico	5
contatosAux	N	Contatos Auxiliares	C123	Alpha Numérico	20
ideNfe	N	Identificador da NFe	123456	Alpha Numérico	5
codModalidadeEnt	N	ID Modalidade de Entrega	1	Alpha Numérico	5
codTurno	N	ID Turno de Entrega	2	Numérico	5
codTipoPedido	N	ID Tipo Pedido/Operação	10	Numérico	5
codGrauRisco	S	ID Grau de Risco	2	Numérico	3
codVen	S	Código do Vendedor / Registro / Código Destinatário	98765	Numérico	20
numDt1	S	Numero DT 1	12345678901	Numérico	20
numDt2	S	Numero DT 2	12345678902	Numérico	20
codTransp	S	ID Transportadora	T1234	Numérico	5
codTransp2	S	ID 2 Transportadora	T567	Numérico	5

Response

Dicionário de Dados

\n\n\n\n\n\n\n\n\n\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 JSON	Descrição	Exemplo	Tipo Interno	Tam. Max.
chaveNfe	Chave da NFe	11330500000108	Numérico	14
codMensagem	Código do Retorno (1-Ok, 2-Erro)	1	Numérico	14
mensagem	Mesnagem Retorno	Ok, dados recebeidos	Alpha Numérico	100

","urlObject":{"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ae3cd97e-ccd4-4df1-a1f6-eb839477d5f9"},{"name":"WEBHOOK - Envio de Trackings (Status ou Ocorrências)","id":"11f0fa10-3f5a-49b1-b30b-7cdaf2378208","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"token","value":"informar_token_fornecido_pela_equipe","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"eventos\": [\r\n\t\t{\r\n\t\t\t\"placaVeiculo\": \"XAS5412\",\r\n\t\t\t\"cpfMotorista\": \"14525214599\",\r\n\t\t\t\"nomeMotorista\": \"JOSE AMORIM\",\r\n\t\t\t\"foneMotorista\": \"11999999999\",\r\n\t\t\t\"cnpjTransportadora\": \"76616119000155\",\r\n\t\t\t\"nomeTransportadora\": \"ALPHA PLUS\",\r\n\t\t\t\"numeroOrdem\": \"XASE1345678\",\r\n\t\t\t\"numeroRemessa\": \"09998465150\",\r\n\t\t\t\"numeroPedido\": \"98165155\",\r\n\t\t\t\"serieNfe\": \"001\",\r\n\t\t\t\"numeroNfe\": \"651651\",\r\n\t\t\t\"chaveNfe\": \"TF54641321332131321543654DS\",\r\n\t\t\t\"serieCte\": \"B\",\r\n\t\t\t\"numeroCte\": \"123456\",\r\n\t\t\t\"chaveCte\": \"TF54641321332131321354654DS\",\r\n\t\t\t\"qtdVolumes\": \"2\",\r\n\t\t\t\"codOcorrencia\": \"1\",\r\n\t\t\t\"descOcorrencia\": \"Entrega Realizada\",\r\n\t\t\t\"datahoraOcorrencia\": \"01/01/2022 13:00\",\r\n\t\t\t\"latitude\": \"-2.526214\",\r\n\t\t\t\"longitude\": \"-4.659887\",\r\n\t\t\t\"nomeRecebedor\": \"JOSE\",\r\n\t\t\t\"docRecebedor\": \"08736333496\",\r\n\t\t\t\"linkPod\": \"https://app.link./juhstg;\"\r\n\t\t}\r\n\t]\r\n}"},"url":"https://url.webhook/myroute/service/dynamicjson1/","description":"

Introdução

URL e Autenticação

A autenticação é feita a partir de token \"fixo\", enviada no header da requisição.

Alterar a \"url.webhook\" pela URL enviada pela equipe de TI do Cliente.

A URL da API, assim como a o Token deve ser solicitados a equipe de TI cliente.

Campos Obrigátorios

Informações sobre campos Obrigatórios.

Observações

Observações sopbre o WEBHOOK

Dicionário de Dados

Campo JSON	Descrição	Exemplo	Tipo	Tam. Max.
placaVeiculo	Placa do Veículo	PCX5214	Alpha Numérico	10
cpfMotorista	CPF do Motorista	251521453	Numérico	14
nomeMotorista	Nome do Motorista	JOSE AMORIM	Alpha Numérico	100
foneMotorista	Telefone do Motorista	83996649718		11
cnpjTransportadora	CNPJ da Transportadora	76616119000155	Numérico	14
nomeTransportadora	Nome da Transportadora	ALPHA PLUS	Alpha Numérico	100
numeroOrdem	Numero da Ordemd e Coleta	55215d1f	Alpha Numérico	20
numeroRemessa	Remessa	09998465150	Alpha Numérico	20
qtdVolumes	Qtd. De Volumes	2	Numérico	6
numeroPedido	Pedido		Numérico	20
serieCte	Serie do CTE	1	Alpha Numérico	10
numeroCte	Numero do Cte	12354	Numérico	20
chaveCte	Chave do CTE		Alpha Numérico	100
serieNfe	Série NFe		Alpha Numérico	10
numeroNfe	Número Ne		Númerico	20
chaveNfe	Chave NFe		Alpha Numérico	100
codOcorrencia	ID da Ocorrência	1	Alpha Numérico	10
descOcorrencia	Descrição da Ocorrência	Entrega Realizada	Alpha Numérico	100
datahoraOcorrencia	Data/Hora que a Ocorrência foi realizada	01/01/2022 16:24	Numérico	2
nomeRecebedor	Nome do Recebedor informado no APP	JOSE	Alpha Numérico	100
docRecebedor	Documento do Recebedor	08736333425	Alpha Numérico	20
latitude	Latitude	-2.526214	Numérico	10
longitude	Longitude	-4.659887	Numérico	10
codBarras	Cod. Barras lidos no APP, podendo ser etiquetas, notas fiscais, etc. No caso de mais de um código,será separado por \";\"	89550318003317218443;89550318003317218823	Alpha Numérico	500
linkPod	Link com a imagem do POD. Pode ser enviados varios, separados por “;”		Alpha Numérico	100

WebHook de envio de retorno de eventos para o Cliente

\n","urlObject":{"protocol":"https","path":["myroute","service","dynamicjson1",""],"host":["url","webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"11f0fa10-3f5a-49b1-b30b-7cdaf2378208"}],"id":"b4674085-06a2-4e46-8173-2831622f3b7b","_postman_id":"b4674085-06a2-4e46-8173-2831622f3b7b","description":""},{"name":"LT-POD","item":[{"name":"WEBHOOK - Envio de Trackings (POD)","id":"55480b20-5b2b-425e-84bf-ef51e9e0c8bc","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"token","value":"informar_token_fornecido_pela_equipe","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"eventos\": [\r\n {\r\n \"numeroOrdem\": \"55215d1f\",\r\n \"numeroRemessa\": \"957-10508374\",\r\n \"codOcorrencia\": \"1\",\r\n \"descOcorrencia\": \"Entrega Realizada\",\r\n \"datahoraOcorrencia\": \"01/01/2022 16:24\",\r\n \"nomeRecebedor\": \"JOSE\",\r\n \"latitude\": \"-2.526214\",\r\n \"longitude\": \"-4.659887\",\r\n \"linkPod\": \"https://app.link./juhstg;\"\r\n }\r\n ]\r\n}\r\n"},"url":"https://url.webhook/myroute/service/dynamicjson1/","description":"

Introdução

A partir desse WEBHOOK, o MyTracking pode enviar para o cliente trackings e POD de uma Entrega ou Coleta como por exemplo \"Entrega Realizada\" e \"Entrega Não Realizada\".

URL e Autenticação

A autenticação é feita a partir de token \"fixo\", enviada no header da requisição.

Alterar a \"url.webhook\" pela URL enviada pela equipe de TI do Cliente.

A URL da API, assim como a o Token deve ser solicitados a equipe de TI cliente.

Campos Obrigátorios

Informações sobre campos Obrigatórios.

Observações

Observações sopbre o WEBHOOK

Dicionário de Dados

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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 JSON	Descrição	Exemplo	Tipo	Tam. Max.
numeroOrdem	Numero da Ordem	55215d1f	Alpha Numérico	20
numeroRemessa	Remessa	957-10508374	Alpha Numérico	20
codOcorrencia	ID da Ocorrência	1	Alpha Numérico	10
descOcorrencia	Descrição da Ocorrência	Entrega Realizada	Alpha Numérico	100
datahoraOcorrencia	Data/Hora que a Ocorrência foi realizada	01/01/2022 16:24	Numérico	2
nomeRecebedor	Nome do Recebedor informado no APP	JOSE	Alpha Numérico	100
latitude	Latitude	-2.526214	Numérico	10
longitude	Longitude	-4.659887	Numérico	10
linkPod	Link com a imagem do POD. Pode ser enviados varios, separados por “;”		Alpha Numérico	100

WebHook de envio de retorno de eventos para o Cliente

\n","urlObject":{"protocol":"https","path":["myroute","service","dynamicjson1",""],"host":["url","webhook"],"query":[],"variable":[]}},"response":[],"_postman_id":"55480b20-5b2b-425e-84bf-ef51e9e0c8bc"}],"id":"9fa5638e-d414-4f26-bb87-8c7733de9816","_postman_id":"9fa5638e-d414-4f26-bb87-8c7733de9816","description":""},{"name":"Tracking 360 - Jornada","item":[{"name":"Cadastro de Colaborador","id":"dc00d3ff-2e4b-45d4-93a9-8c5b280a742d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Token","value":"(Dispoibilizado pelo MT)","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"motoristas\": [\r\n {\r\n \"cnpjCd\": \"55062532000145\",\r\n \"nomeMotorista\": \"Fulano da Silva\",\r\n \"cpfMotorista\": \"12345678900\",\r\n \"placaVeiculo\": \"ABC1D23\",\r\n \"telefoneMotorista\": \"11988887777\",\r\n \"dataNascimento\": \"21/04/1990\",\r\n \"tipoVeiculo\": \"3\",\r\n \"motoristaAtivo\": \"S\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://url/api/dinamicjson2/","description":"

API MyTracking – Cadastro de Motoristas (WS JSON)

Informações Gerais

Tipo de Integração: WS JSON
\n
Versão do Documento: 1.0
\n
Data de Revisão: 30/01/2026
\n
Ambiente: Produção
\n
Responsável:
\n

Objetivo

Esta API é responsável pelo cadastro e manutenção de motoristas no MyTracking, permitindo criar, atualizar e ativar/inativar motoristas, bem como vinculá-los a veículos e Centros de Distribuição (CD).

A identificação do motorista no sistema é feita de forma única pelo CPF (cpfMotorista).

Visão Geral da API

Endpoint: https://url/api/dinamicjson2/
\n
Método HTTP: POST
\n
Formato: application/json
\n
Tipo de Envio: Lote (batch) de motoristas através do array motoristas[].
\n

Autenticação

A autenticação é realizada via token fixo, enviado no header da requisição.

Headers Obrigatórios

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

Chave	Valor	Observação
Content-Type	application/json	Obrigatório
token	(fornecido pela MyTracking)	Obrigatório. Enviar exatamente como informado

Request

Estrutura do Payload

O request aceita o envio de um ou mais motoristas no mesmo payload, através do array motoristas.

Exemplo de Request JSON

{\n  \"motoristas\": [\n    {\n      \"cnpjCd\": \"55062532000145\",\n      \"nomeMotorista\": \"Fulano da Silva\",\n      \"cpfMotorista\": \"12345678900\",\n      \"placaVeiculo\": \"ABC1D23\",\n      \"telefoneMotorista\": \"11988887777\",\n      \"dataNascimento\": \"21/04/1989\",\n      \"tipoVeiculo\": \"3\",\n      \"motoristaAtivo\": \"S\"\n    }\n  ]\n}\n\n

Campos do Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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	Obrigatório	Descrição	Tipo	Tamanho Máx.
cnpjCd	Sim	CNPJ do Centro de Distribuição (CD) de referência de alocação do motorista	Numérico (string)	14
nomeMotorista	Sim	Nome completo do motorista.	Alfa numérico	50
cpfMotorista	Sim	Identificador único do motorista no MyTracking (chave lógica).	Numérico (string)	11
placaVeiculo	Sim	Placa do veículo vinculada ao motorista.	Alfa numérico	7
telefoneMotorista	Sim	Telefone do motorista para uso no aplicativo (somente dígitos).	Numérico (string)	11
dataNascimento	Sim	Data de nascimento no padrão `DD/MM/YYYY`.	Data (string)	10
tipoVeiculo	Sim	Código referencial do tipo de veículo no MyTracking.	Numérico (string)	3
motoristaAtivo	Sim	Indica se o motorista está ativo (`S`) ou inativo (`N`).	Alfa numérico	1

Regras e Validações

Campos numéricos devem conter apenas dígitos.
\n
O campo cpfMotorista é a chave única do motorista no MyTracking:
\n
- Caso o CPF já exista, o sistema realizará atualização dos dados enviados.
  \n
- Campos não enviados permanecerão com os valores já cadastrados.
  \n
\n
O campo cnpjCd deve estar previamente cadastrado:
\n
- Caso o CD não exista ou não esteja vinculado, a integração poderá ser rejeitada.
\n
O campo motoristaAtivo aceita exclusivamente:
\n
- \"A\" para motorista ativo
  \n
- \"I\" para motorista inativo
  \n
\n
O campo dataNascimento deve seguir obrigatoriamente o padrão DD/MM/YYYY (ex.: 21/04/1987).
\n
Recomenda-se implementar controle de retry com tratamento de duplicidade.
\n

Response

Sucesso – HTTP 200

{\n  \"motoristas\": [\n    {\n      \"cpfMotorista\": \"12345678900\",\n      \"codMensagem\": \"1\",\n      \"mensagem\": \"Motorista integrado com sucesso\"\n    }\n  ]\n}\n\n

Erro por Registro (mesmo retornando HTTP 200)

Mesmo quando ocorre erro em um registro específico, a API pode retornar HTTP 200, informando o erro por item.

{\n  \"motoristas\": [\n    {\n      \"cpfMotorista\": \"12345678900\",\n      \"codMensagem\": \"2\",\n      \"mensagem\": \"Tipo de veículo inválido\"\n    }\n  ]\n}\n\n

Erro HTTP (4xx / 5xx)

Quando a requisição falha por erro de autenticação, JSON inválido ou erro interno, o retorno pode ser:

{\n  \"mensagem\": \"Erro\"\n}\n\n

Campos do Response

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

Campo	Descrição
cpfMotorista	CPF informado no request, utilizado para correlação
codMensagem	Código de retorno do processamento (1 = sucesso; diferente de 1 = erro)
mensagem	Descrição do resultado do processamento do registro

Boas Práticas de Integração

Realizar o cadastro dos motoristas antes da integração de jornadas, pontos ou rotas.
\n
Manter o cadastro sempre atualizado, principalmente tipoVeiculo e motoristaAtivo.
\n
Monitorar o retorno da API para tratamento de falhas parciais por item.
\n
Não reutilizar CPF para motoristas diferentes.
\n

Histórico de Revisões

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

Data	Versão	Alteração
30/01/2026	1.0	Primeira versão da documentação – Cadastro de Motoristas

","urlObject":{"protocol":"https","path":["api","dinamicjson2",""],"host":["url"],"query":[],"variable":[]}},"response":[],"_postman_id":"dc00d3ff-2e4b-45d4-93a9-8c5b280a742d"},{"name":"Jornada de Trabalho","id":"8bbb4690-9e23-4490-b182-c90d69c3f4a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Token","value":"(Dispoibilizado pelo MT)","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"jornadas\": [\r\n {\r\n \"cpfMotorista\": \"06787631098\",\r\n \"dataBase\": \"26-11-2025\",\r\n \"inicioJornada\": \"26-11-2025 07:00\",\r\n \"fimJornada\": \"26-11-2025 17:00\"\r\n },\r\n {\r\n \"cpfMotorista\": \"06787631098\",\r\n \"dataBase\": \"26-11-2025\",\r\n \"inicioJornada\": \"26-11-2025 07:00\",\r\n \"fimJornada\": \"26-11-2025 17:00\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://url/api/dinamicjson2/","description":"

API MyTracking – Jornada Planejada

Informações Gerais

Tipo de Integração: WS JSON
\n
Versão do Documento: 1.0
\n
Data de Revisão: 30/01/2026
\n
Ambiente: Produção
\n
Responsável:
\n

Objetivo

Sincronizar diariamente a escala operacional dos motoristas, garantindo visibilidade antecipada da disponibilidade dos recursos e suporte às automações do MyTracking.

Disparo do Envio

Disparo diário, com antecedência mínima de 7 dias, contendo:

CPF do motorista
\n
Data-base (dia de referência)
\n
Horário planejado de início
\n
Horário planejado de fim
\n

Observação importante:

Toda lógica de escala e calendário é centralizada no Fortes. Não há manutenção de jornada diretamente no MyTracking.

Visão Geral da API

Endpoint: https://url/api/dinamicjson2/
\n
Método HTTP: POST
\n
Formato: application/json
\n
Tipo de Envio: Lote (batch) através do array jornada[]
\n

Autenticação

A autenticação é realizada via token fixo, enviado no header da requisição.

Headers Obrigatórios

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

Chave	Valor	Observação
Content-Type	application/json	Obrigatório
token	(fornecido pela MyTracking)	Obrigatório. Enviar exatamente como informado

Request

Estrutura do Payload

O request aceita o envio de uma ou mais jornadas no mesmo payload, através do array jornada.

Exemplo de Request JSON

{\n  \"jornada\": [\n    {\n      \"cpfMotorista\": \"06787631098\",\n      \"dataBase\": \"26-11-2025\",\n      \"inicioJornada\": \"26-11-2025 07:00\",\n      \"fimJornada\": \"26-11-2025 17:00\"\n    },\n    {\n      \"cpfMotorista\": \"06787631098\",\n      \"dataBase\": \"26-11-2025\",\n      \"inicioJornada\": \"26-11-2025 07:00\",\n      \"fimJornada\": \"26-11-2025 17:00\"\n    }\n  ]\n}\n\n

Campos do Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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	Obrigatório	Descrição	Tipo	Formato / Exemplo
cpfMotorista	Sim	Identificador único do motorista no MyTracking	string	`\"06787631098\"`
dataBase	Sim	Dia de referência da jornada	string	`DD-MM-YYYY` (ex.: `\"26-11-2025\"`)
inicioJornada	Sim	Data e horário planejado de início	string	`DD-MM-YYYY HH:mm` (ex.: `\"26-11-2025 07:00\"`)
fimJornada	Sim	Data e horário planejado de término	string	`DD-MM-YYYY HH:mm` (ex.: `\"26-11-2025 17:00\"`)

Regras e Validações

Envio diário, com antecedência mínima de 7 dias.
\n
dataBase deve estar no padrão DD-MM-YYYY.
\n
inicioJornada e fimJornada devem estar no padrão DD-MM-YYYY HH:mm.
\n
Recomenda-se manter inicioJornada < fimJornada.
\n
A jornada é planejada (escala). A manutenção de escala/calendário ocorre no Fortes (fonte de verdade).
\n

Sucesso – HTTP 200 (exemplo)

{\n  \"jornada\": [\n    {\n      \"cpfMotorista\": \"06787631098\",\n      \"dataBase\": \"26-11-2025\",\n      \"codMensagem\": \"1\",\n      \"mensagem\": \"Jornada integrada com sucesso\"\n    }\n  ]\n}\n\n

Erro por item – HTTP 200 (exemplo)

{\n  \"jornada\": [\n    {\n      \"cpfMotorista\": \"06787631098\",\n      \"dataBase\": \"26-11-2025\",\n      \"codMensagem\": \"2\",\n      \"mensagem\": \"Motorista não encontrado\"\n    }\n  ]\n}\n\n

Erro HTTP (4xx/5xx) (exemplo)

{\n  \"mensagem\": \"Erro\"\n}\n\n

Histórico de Revisões

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

Data	Versão	Alteração
30/01/2026	1.0	Primeira versão da documentação – Jornada Planejada

","urlObject":{"protocol":"https","path":["api","dinamicjson2",""],"host":["url"],"query":[],"variable":[]}},"response":[],"_postman_id":"8bbb4690-9e23-4490-b182-c90d69c3f4a3"},{"name":"Eventos de Ponto","id":"4c2a0d53-0d16-4e52-85f2-e787d0edeef3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Token","value":"(Dispoibilizado pelo MT)","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"ponto\": [\r\n {\r\n \"cpfMotorista\": \"06787631098\",\r\n \"tipo\": \"1\",\r\n \"dataBase\": \"26-11-2025\",\r\n \"dataCapturaPonto\": \"26-11-2025 09:00\"\r\n },\r\n {\r\n \"cpfMotorista\": \"06787631098\",\r\n \"tipo\": \"2\",\r\n \"dataBase\": \"26-11-2025\",\r\n \"dataCapturaPonto\": \"26-11-2025 17:10\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://url/api/dinamicjson2/","description":"

API MyTracking – Eventos de Ponto

Informações Gerais

Tipo de Integração: WS JSON
\n
Versão do Documento: 1.0
\n
Data de Revisão: 30/01/2026
\n
Ambiente: Produção
\n
Responsável:
\n

Objetivo

Sincronizar a execução real da jornada dos motoristas, garantindo controle operacional em tempo real e auditoria completa sobre divergências entre o planejado e o realizado.

Disparo do Envio

Disparo em tempo real, sempre que ocorrer:

Ponto de entrada
\n
Ponto de saída
\n

Visão Geral da API

Endpoint: https://url/api/dinamicjson2/
\n
Método HTTP: POST
\n
Formato: application/json
\n
Tipo de Envio: Lote (batch) através do array ponto[]
\n

Autenticação

A autenticação é realizada via token fixo, enviado no header da requisição.

Headers Obrigatórios

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

Chave	Valor	Observação
Content-Type	application/json	Obrigatório
token	(fornecido pela MyTracking)	Obrigatório. Enviar exatamente como informado

Request

Estrutura do Payload

O request aceita o envio de um ou mais registros de ponto no mesmo payload, através do array ponto.

Exemplo de Request JSON

{\n  \"ponto\": [\n    {\n      \"cpfMotorista\": \"06787631098\",\n      \"tipo\": \"1\",\n      \"dataBase\": \"26-11-2025\",\n      \"dataCapturaPonto\": \"26-11-2025 09:00\"\n    },\n    {\n      \"cpfMotorista\": \"06787631098\",\n      \"tipo\": \"2\",\n      \"dataBase\": \"26-11-2025\",\n      \"dataCapturaPonto\": \"26-11-2025 17:10\"\n    }\n  ]\n}\n\n

Campos do Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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	Obrigatório	Descrição	Tipo	Formato / Exemplo
cpfMotorista	Sim	Identificador único do motorista	string	`\"06787631098\"`
tipo	Sim	Tipo do evento de ponto (`1` = Entrada / `2` = Saída)	string	`\"1\"` / `\"2\"`
dataBase	Sim	Dia de referência da jornada	string	`DD/MM/YYYY` (ex.: `\"26-11-26\"`)
dataCapturaPonto	Sim	Data e horário real da batida de ponto	string	`DD/MM/YYYY HH:mm` (ex.: `\"26-11-26 09:00\"`)

Regras e Validações

O envio ocorre em tempo real (entrada/saída).
\n
tipo aceita:
\n
- \"1\" = Entrada
  \n
- \"2\" = Saída
  \n
\n
dataBase deve estar no padrão DD/MM/YYYY.
\n
dataCapturaPonto deve estar no padrão DD/MM/YYYY HH:mm.
\n
Recomenda-se consistência entre dataBase e a data de dataCapturaPonto (mesmo dia), salvo regra específica do cliente.
\n
Recomenda-se enviar eventos na ordem cronológica (entrada antes da saída).
\n

Sucesso – HTTP 200 (exemplo)

{\n  \"ponto\": [\n    {\n      \"cpfMotorista\": \"06787631098\",\n      \"dataBase\": \"26-11-2025\",\n      \"tipo\": \"1\",\n      \"codMensagem\": \"1\",\n      \"mensagem\": \"Ponto integrado com sucesso\"\n    }\n  ]\n}\n\n

Erro HTTP (4xx/5xx) (exemplo)

{\n  \"mensagem\": \"Erro\"\n}\n\n

Histórico de Revisões

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

Data	Versão	Alteração
30/01/2026	1.0	Primeira versão da documentação – Eventos de Ponto

","urlObject":{"protocol":"https","path":["api","dinamicjson2",""],"host":["url"],"query":[],"variable":[]}},"response":[],"_postman_id":"4c2a0d53-0d16-4e52-85f2-e787d0edeef3"}],"id":"8302beed-ac6a-439a-a19f-ccae5695739c","_postman_id":"8302beed-ac6a-439a-a19f-ccae5695739c","description":""}]}