postman.pointsistemas.com.br Open in urlscan Pro
3.91.254.49  Public Scan

Form analysis
0 forms found in the DOM

Text Content

 * Body
 * Headers (0)

 * Body
 * Headers (0)




Public


Documentation Settings
ENVIRONMENT
No Environment

LAYOUT
Double Column

LANGUAGE
cURL - cURL


MyTracking - Documentação Padrão
Introduction
Tracking 360
Links
Widgets
Conferência


MYTRACKING - DOCUMENTAÇÃO PADRÃO

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.


TRACKING 360




POSTAPI - CRIAÇÃO DE EVENTOS (ENTREGA, COLETA, SERVIÇOS)

https://url.api/myroute/service/dynamicjson1/


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

View More

Campo JSONDescriçãoExemploTipo InternoTam. Max.cnpjCdCnpj do
CD11330500000108Numérico14codCdCódigo do CD1Numérico14codCdpaiCódigo do CD
Pai35Alpha Numérico10tipoOpeTipo de Operação (1-Entrega, 2-Coleta)35Alpha
Numérico10agrupadorRotaAgrupador das Eventos para formação de carga (Manifesto,
romaneio, DT Documento de Transporte)205060Alpha
Numérico20numeroManifestoNúmero/Código do Manifesto205060Alpha
Numérico20dataManifestoData de Emissão do manifesto ou
romaneioData10dataPrevIniViagemData/Hora Previsão Inicio da Viagem
(Roteiro)Data/hora16tipoEventoID do tipo de Evento (lista
cadastrada)1Numérico3tipoFreteID do tipo de frete (lista
cadastrada)1Numérico3numeroPedidoPedido282522Numérico10dataPedidoData de emissão
do pedido18/04/2022 14:00Data/hora16numeroRemessaRemessaREM151213Alpha
Numérico20codRastreamentoEcomCodigo de rastreamento para ECOMERCE ou
AEREO85432321Alpha Numérico20codSetorSetor700Alpha Numérico5numeroOrdemNumero de
Ordem (Usado para quando for uma Coleta)ORD854125Alpha Numérico20serieNfeSerie
da Nfe1Alpha Numérico3numeroNfeNumero da Nfe1038707Numérico10dataNfeData de
emissão da Nfe11/04/2022 00:00Data/hora16chaveNfeChave da
NfeXD3522045572822400010Alpha Numérico20serieCteSerie do Cte1Alpha
Numérico3numeroCteNumero do Cte49612Numérico10dataCteData de emissão do
CTe14/04/2022 14:00Data/hora16chaveCteChave do CteTF105572822400010612042Alpha
Numérico20valorPedidoValor do Pedido60.00Numérico12valorNfeValor da Nota
Fiscal60.00Numérico12valorEventoValor do Evento (Valor da Entrega ou
Coleta)60.00Numérico12valorEventoSipValor do Frete sem
Impostos60.00Numérico12valorFreteEventoValor do
Frete60.00Numérico12obsEventoObservação de EventoENTREGAR NA PORTARIAAlpha
Numérico20volumeEventoVolume em m³50.00Numérico12pesoEventoPeso em
KG100.00Numérico12qtdVolumesQtd. De Volumes2Numérico6dataPrvEntIniData Previsão
de Evento (Janela Inicio)18/04/2022 13:00Data/hora16dataPrvEntFimData Previsão
de Evento (Janela Fim)19/04/2022 19:00Data/hora16dataAgendaIniData agendamento
de Evento (Janela Inicio)19/04/2022Data/hora16dataAgendaFimData agendamento de
Evento (Janela Fim)20/04/2022Data/hora16leadTimeLead time de
Evento15Numérico2dataManifestoData do
Manifesto18/04/2022Data/hora16tipoCargaCódigo do Tipo de Carga20Alpha
Numérico10tipoPagamentoCódigo do Tipo de Pagamento20Alpha
Numérico10cnpjCpfDesCNPJ ou CPF do
destinatario5418750Numérico8inscEstadualDesInscrição Estadual do
Destinatario253568798Numérico9nomeDesNomeMARIO ANDRADEAlpha
Numérico100endDesEndereçoRUA TRÊSAlpha Numérico100numDesNumero82Alpha
Numérico20baiDesBairroJARDIM BELOAlpha Numérico100cidDesCidadeSAO PAULOAlpha
Numérico100ufDesUFSPAlpha Numérico2cplDesComplementoSALA 25Alpha
Numérico40cepDesCEP3241010Numérico9siglaPaisDestSigla do Pais (se não enviar é
considerador BR)BRAlpha Numérico2obsEndDesObservação do EndereçoTOCAR A
CAMPAINHAAlpha
Numérico100latitudeEndDesLatitude-2.526214Numérico10longitudeEndDesLongitude-4.659887Numérico10telefoneDesTelefone
Principal11999999999Numérico11telefoneDes2Telefone
Secundario11999999999Numérico11emailDesEmailjose@uol.comAlpha
Numérico100cnpjCpfEmitenteCnpj do Emitente
(embarcador)1E+14Numérico14nomeEmitenteNome EmitenteEMPRESA XYZ S/AAlpha
Numérico100inscEstadualEmitenteInscrição Estadual do Emitente
(embarcador)253568798Numérico9endEmitenteEndereçoALAMEDA MAMORÉAlpha
Numérico100baiEmitenteBairroALPHAVILLE INDUSTRIALAlpha
Numérico100cidEmitenteCidadeBARUERIAlpha Numérico100ufEmitenteUFSPAlpha
Numérico2numEmitenteNumero911Alpha Numérico20cplEmitenteComplementoSALA
1602Alpha Numérico40cepEmitenteCEP6454040Numérico9cnpjTransportadoraCNPJ da
Transportadora1E+14Numérico14nomeTransportadoraNome da TransportadoraALPHA
PLUSAlpha Numérico100inscEstadualTraInscrição
Estadual253568798Numérico9cpfMotoristaCPF do
Motorista25822512345Numérico11nomeMotoristaNome do MotoristaJOSE AMORIMAlpha
Numérico100foneMotoristaTelefone do Motorista1,2E+11Numérico11placaVeiculoPlaca
do VeículoASG5107Alpha Numérico7siglaBaseOrigemSigla da Base de Origem (ex.:
CGH)CGHAlpha Numérico5siglaBaseDestinoSigla da Base de Destino (ex.:
REC)RECAlpha Numérico5criarRoteiroAppCriar Roteiro APP: 0-"Não Cria", 1-Criar
via "agrupadorRota", 2-Criar via
"numeroManifesto"0Numérico5enviarRoteirizadorEnviar Roteirização: 0-Não enviar,
1-Enviar0NuméricocodBarrasCódigo de Barras para localização do
Evento12345689Numérico30codCorCódigo da Cor para o ponto no Mapa – Tabela
Interna (utilizado no Roteirizador)1Numérico2chvProdutoChave do Produto padrão
para o EventoAlpha Numérico5delTypeDelivery Type (código interno AVON, Latam,
Etc)Alpha Numérico50

API de envio de eventos para o MyTracking

HEADERS
Content-Type

application/json

token

informar_token_fornecido_pela_equipe

Bodyraw
View More

{
    "eventos": [
        {
            "cnpjCd": "99999999999991",
            "codCd": "001",
            "codCdpai": "001",
            "tipoOpe": "1",
            "agrupadorRota": "3054",
            "numeroManifesto": "205060",
            "dataManifesto": "01/01/2022",
            "dataPrevIniViagem": "01/01/2022 08:00",
            "tipoEvento": "",
            "tipoFrete": "",
            "numeroPedido": "282522",
            "dataPedido": "18/04/2022 14:00",
            "numeroRemessa": "151213",
            "codRastreamentoEcom": "",
            "codSetor": "2",
            "numeroOrdem": "123",
            "serieNfe": "001",
            "numeroNfe": "1038707",
            "dataNfe": "11/04/2022 00:00",
            "chaveNfe": "35220455728224000106550010010387071032145773",
            "serieCte": "1",
            "numeroCte": "49612",
            "dataCte": "",
            "chaveCte": "10557282240001061204202206314000100000049612",
            "valorPedido": "60.00",
            "valorNfe": "60.00",
            "valorEvento": "60.00",
            "valorEventoSip": "60.00",
            "valorFreteEvento": "60.00",
            "obsEvento": "Teste de integração",
            "volumeEvento": "50.00",
            "pesoEvento": "100.00",
            "qtdVolumes": "2",
            "dataPrvEntIni": "18/04/2022 14:00",
            "dataPrvEntFim": "19/04/2022 14:00",
            "dataAgendaIni": "19/04/2022 14:00",
            "dataAgendaFim": "20/04/2022 14:00",
            "leadTime": "15",
            "dataManifesto": "18/04/2022 14:00",
            "tipoCarga": "20",
            "tipoPagamento": "",
            "cnpjCpfDes": "05418750860",
            "inscEstadualDes": "",
            "nomeDes": "MARIO ANDRADE",
            "endDes": "RUA TRÊS",
            "numDes": "82",
            "baiDes": "JARDIM BELO",
            "cidDes": "SAO PAULO",
            "ufDes": "SP",
            "cplDes": "",
            "cepDes": "03241010",
            "siglaPaisDest": "",
            "obsEndDes": "",
            "latitudeEndDes": "",
            "longitudeEndDes": "",
            "telefoneDes": "11986372897",
            "telefoneDes2": "",
            "emailDes": "jose@uol.com",
            "cnpjCpfEmitente": "8142803000192",
            "nomeEmitente": "EMPRESA XYZ S/A",
            "inscEstadualEmitente": "",
            "endEmitente": "ALAMEDA MAMORE",
            "baiEmitente": "ALPHAVILLE INDUSTRIAL",
            "cidEmitente": "BARUERI",
            "ufEmitente": "SP",
            "numEmitente": "911",
            "cplEmitente": "SALA 1602",
            "cepEmitente": "06454040",
            "cnpjTransportadora": "9999999999997",
            "nomeTransportadora": "ALPHA PLUS",
            "inscEstadualTra": "",
            "cpfMotorista": "",
            "nomeMotorista": "JOAO CASTRO",
            "foneMotorista": "11986372897",
            "placaVeiculo": "ASG5107",
            "siglaBaseOrigem": "",
            "siglaBaseDestino": "",
            "criarRoteiroApp": "",
            "enviarRoteirizador": "",
            "codBarras": "",
            "codCor": "",
            "chvProduto": "",
            "delType": ""
        }
    ]
}

Example Request
API - Criação de Eventos (Entrega, Coleta, Serviços)

View More
curl


curl --location --request POST 'https://url.api/myroute/service/dynamicjson1/' \
--header 'Content-Type: application/json' \
--header 'token: informar_token_fornecido_pela_equipe' \
--data-raw '{
    "eventos": [
        {
            "cnpjCd": "99999999999991",
            "codCd": "001",
            "codCdpai": "001",
            "tipoOpe": "1",
            "agrupadorRota": "3054",
            "numeroManifesto": "205060",
            "dataManifesto": "01/01/2022",
            "dataPrevIniViagem": "01/01/2022 08:00",
            "tipoEvento": "",
            "tipoFrete": "",
            "numeroPedido": "282522",
            "dataPedido": "18/04/2022 14:00",
            "numeroRemessa": "151213",
            "codRastreamentoEcom": "",
            "codSetor": "2",
            "numeroOrdem": "123",
            "serieNfe": "001",
            "numeroNfe": "1038707",
            "dataNfe": "11/04/2022 00:00",
            "chaveNfe": "35220455728224000106550010010387071032145773",
            "serieCte": "1",
            "numeroCte": "49612",
            "dataCte": "",
            "chaveCte": "10557282240001061204202206314000100000049612",
            "valorPedido": "60.00",
            "valorNfe": "60.00",
            "valorEvento": "60.00",
            "valorEventoSip": "60.00",
            "valorFreteEvento": "60.00",
            "obsEvento": "Teste de integração",
            "volumeEvento": "50.00",
            "pesoEvento": "100.00",
            "qtdVolumes": "2",
            "dataPrvEntIni": "18/04/2022 14:00",
            "dataPrvEntFim": "19/04/2022 14:00",
            "dataAgendaIni": "19/04/2022 14:00",
            "dataAgendaFim": "20/04/2022 14:00",
            "leadTime": "15",
            "dataManifesto": "18/04/2022 14:00",
            "tipoCarga": "20",
            "tipoPagamento": "",
            "cnpjCpfDes": "05418750860",
            "inscEstadualDes": "",
            "nomeDes": "MARIO ANDRADE",
            "endDes": "RUA TRÊS",
            "numDes": "82",
            "baiDes": "JARDIM BELO",
            "cidDes": "SAO PAULO",
            "ufDes": "SP",
            "cplDes": "",
            "cepDes": "03241010",
            "siglaPaisDest": "",
            "obsEndDes": "",
            "latitudeEndDes": "",
            "longitudeEndDes": "",
            "telefoneDes": "11986372897",
            "telefoneDes2": "",
            "emailDes": "jose@uol.com",
            "cnpjCpfEmitente": "8142803000192",
            "nomeEmitente": "EMPRESA XYZ S/A",
            "inscEstadualEmitente": "",
            "endEmitente": "ALAMEDA MAMORE",
            "baiEmitente": "ALPHAVILLE INDUSTRIAL",
            "cidEmitente": "BARUERI",
            "ufEmitente": "SP",
            "numEmitente": "911",
            "cplEmitente": "SALA 1602",
            "cepEmitente": "06454040",
            "cnpjTransportadora": "9999999999997",
            "nomeTransportadora": "ALPHA PLUS",
            "inscEstadualTra": "",
            "cpfMotorista": "",
            "nomeMotorista": "JOAO CASTRO",
            "foneMotorista": "11986372897",
            "placaVeiculo": "ASG5107",
            "siglaBaseOrigem": "",
            "siglaBaseDestino": "",
            "criarRoteiroApp": "",
            "enviarRoteirizador": "",
            "codBarras": "",
            "codCor": "",
            "chvProduto": "",
            "delType": ""
        }
    ]
}'

Example Response
 * Body
 * Headers (0)

No response body
This request doesn't return any response body
No response headers
This request doesn't return any response headers


POSTWEBHOOK - ENVIO DE TRACKINGS (STATUS OU OCORRÊNCIAS)

https://url.webhook/myroute/service/dynamicjson1/


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

View More

Campo JSONDescriçãoExemploTipoTam. Max.placaVeiculoPlaca do VeículoPCX5214Alpha
Numérico10cpfMotoristaCPF do Motorista251521453Numérico14numeroOrdemNumero da
Ordemd e Coleta55215d1fAlpha Numérico20numeroRemessaRemessaAlpha
Numérico20numeroPedidoPedidoNumérico20serieCteSerie do CTE1Alpha
Numérico10numeroCteNumero do Cte12354Numérico20chaveCteChave do CTEAlpha
Numérico100serieNfeSérie NFeAlpha Numérico10numeroNfeNúmero
NeNúmerico20chaveNfeChave NFeAlpha Numérico100codOcorrenciaID da
Ocorrência1Alpha Numérico10descOcorrenciaDescrição da OcorrênciaEntrega
RealizadaAlpha Numérico100datahoraOcorrenciaData/Hora que a Ocorrência foi
realizada01/01/2022 16:24Numérico2nomeRecebedorNome do Recebedor informado no
APPJOSEAlpha Numérico100codBarrasCod. Barras lidos no APP, podendo ser
etiquetas, notas fiscais, etc. No caso de mais de um código,será separado por
";"89550318003317218443;89550318003317218823Alpha Numérico500linkPodLink com a
imagem do POD. Pode ser enviados varios, separados por “;”Alpha Numérico100

WebHook de envio de retorno de eventos para o Cliente

HEADERS
Content-Type

application/json

token

informar_token_fornecido_pela_equipe

Bodyraw
View More

{
    "eventos": [
        {
            "placaVeiculo": "XAS5412",
            "cpfMotorista": "14525214599",
            "numeroOrdem": "XASE1345678",
            "serieCte": "B",
            "numeroCte": "123456",
            "chaveCte": "TF5464132133213132154654DS",
            "codOcorrencia": "1",
            "descOcorrencia": "Entrega Realizada",
            "datahoraOcorrencia": "01/01/2022 13:00",
            "nomeRecebedor": "JOSE",
            "chaveNfeColeta": "5214201542154212541542156421542154;5463546546545421321354584543;",
            "linkPod": "https://app.link./juhstg;"
        }
    ]
}

Example Request
WEBHOOK - Envio de Trackings (Status ou Ocorrências)

View More
curl


curl --location --request POST 'https://url.webhook/myroute/service/dynamicjson1/' \
--header 'Content-Type: application/json' \
--header 'token: informar_token_fornecido_pela_equipe' \
--data-raw '{
    "eventos": [
        {
            "placaVeiculo": "XAS5412",
            "cpfMotorista": "14525214599",
            "numeroOrdem": "XASE1345678",
            "serieCte": "B",
            "numeroCte": "123456",
            "chaveCte": "TF5464132133213132154654DS",
            "codOcorrencia": "1",
            "descOcorrencia": "Entrega Realizada",
            "datahoraOcorrencia": "01/01/2022 13:00",
            "nomeRecebedor": "JOSE",
            "chaveNfeColeta": "5214201542154212541542156421542154;5463546546545421321354584543;",
            "linkPod": "https://app.link./juhstg;"
        }
    ]
}'

Example Response
 * Body
 * Headers (0)

No response body
This request doesn't return any response body
No response headers
This request doesn't return any response headers

WIDGETS