Integração Protheus – API Previsão de Entregas

Modificado em Qui, 23 Out na (o) 10:05 AM

ESPECIFICAÇÃO TÉCNICA

Departamento:	Gestão de Fretes
Gerente do Projeto/Analista Responsável:	Carlos Galimbert	Versão do documento:	1.0
		Data da versão do documento:	26/09/2025

Preparado por:	Rodrigo Ferreira Rother	Data de preparação:	26/09/2025
Revisado por:	João Felipe Martins	Data de revisão:	26/09/2025

Lista de Distribuição

De	Data	Fone/Fax
Rodrigo Ferreira Rother	26/09/2025

Para	Ação*	Até	Fone/Fax
Alessandra Baraldi	Documentação técnica
Leandro Franco

* Action Types: Approve, Review, Inform, File, Action Required

Histórico

Ver. No.	Data ver.	Revisado por	Descrição	Arquivo
1.0	29/09/2025	João Felipe Martins

Objetivo

Implementar a inclusão do prazo de entrega das transportadoras, obtido via API, no momento da importação do CTe e da geração do documento de frete.

Escopo

Implementar a busca da previsão de entrega via API das transportadoras assim que ocorrer a importação do CTe e a geração do documento de frete.

Atualmente, o sistema utiliza como parâmetro a previsão de entrega por cidades, a qual deverá ser mantida. Adicionalmente, será incluída uma nova coluna na rotina GFEA051, denominada "Dt Prev Entrega Transp", que apresentará a data de entrega informada via API pela transportadora responsável pelo frete.

A previsão de entrega será obtida por meio de integração com API das seguintes transportadoras:

• Braspress

• Rodonaves

• Gollog / SJP Cargo

• Jamef

• TNT

• Ativa

A rotina de busca da data de previsão de entrega da transportadora será executada diariamente por meio de agendamento (schedule).

Atualiza Data de Entrega:

Rotina: XDSGFE03 – Atualiza Dt Entrega Frete

Interface gráfica do usuário, Texto, Aplicativo
O conteúdo gerado por IA pode estar incorreto.

Registro da Entrega:

Rotina GFEA051 – Registar Entrega

Tela de computador com texto preto sobre fundo branco
O conteúdo gerado por IA pode estar incorreto.

Fluxo do processo:

Diagrama
O conteúdo gerado por IA pode estar incorreto.

Dicionário de Dados:

Tabelas e campos:

Tabelas:

Tabela: GWU010

Campos:

GWU_DTPREN – Campo da data prevista transportadora

Gatilhos:

Não se aplica

Parâmetros:

MV_TNTUSER – Usuário para acesso a TNT

MV_TNTPASS – Senha de acesso a TNT

MV_JAMUSER – Usuário para acesso a Jamef

MV_JAMPASS – Senha de acesso a Jamef

Código fonte utilizados:

Nome	Conteúdo
DSGFE003.prw	Atualiza previsão de entregas

ATIVA

<message>Documento localizado com sucesso</message>

<remetente>Ds Schiavetto E Cia Ltda</remetente>

<destinatario>Cornelio Auto Pecas Ltda - Epp</destinatario>

<nro_nf>158187</nro_nf>

</header>

<items>

<item>

<data_hora>2025-08-06T18:08:05</data_hora>

<cidade>SAO JOSE DO RIO PRETO / SP</cidade>

<ocorrencia>DOCUMENTO DE TRANSPORTE EMITIDO (97)</ocorrencia>

<descricao>CT-e autorizado com 5 volumes e 33 Kg. Destino: SP/PRAIA GRANDE. Previsao de entrega: 12/08/25.</descricao>

BRASPRESS

{"conhecimentos":

[{"statusEntrega":null,

"numero":"002841942",

"origem":"SJP",

"destino":"REC",

"emissao":"08/08/2025",

"remetente":"D.S. SCHIAVETTO E CIA LTDA",

"destinatario":"FORTBRAS AUTOPECAS S.A.",

"tipoFrete":"CIF",

"volumes":4,

"valorMercantil":7918.44,

"peso":14.82,

"totalFrete":169.79,

"previsaoEntrega":"19/08/2025",

"dataEntrega":null,

SJP/GOLLOG

{"Conhecimento":"40258080",

"Entregue":"Nao",

"Erro":"0",

"MsgErro":"",

"PrevEntrega":"15/08/2025",

"Ocorrencias":

[{"Ocorrencia":

[{"Data":"11/08/2025"},

{"Hora":"16:21"},

{"sOcorrencia":"Carga manifestada"}]},

{"Ocorrencia":[{"Data":"08/08/2025"},

{"Hora":"19:00"},

{"sOcorrencia":"Emitido"}]}]}

JAMEF

{

"situacao": 200,

"mensagem": "Foram retornados 1 registros",

"dado": [

{

"rastreamento": [

{

"tipo": "CTE",

"remetente": {

"nome": "D.S. SCHIAVETTO & CIA LTDA.",

"cidade": "SAO JOSE DO RIO PRETO",

"uf": "SP"

"destinatario": {

"nome": "A M 163 COMERCIO DE PECAS LTDA - ME",

"cidade": "RIO DE JANEIRO",

"uf": "RJ"

"conhecimento": {

"numero": "000452926",

"serie": "1",

"chave": "35250820147617003400570010004529261786224726"

"notaFiscal": {

"numero": "158298",

"serie": "0",

"chave": "35250805819698000195550000001582981453379874",

"pedido": ""

"frete": {

"valorFrete": "330.19",

"previsaoEntrega": "2025-08-12",

"urlComprovanteEntrega": " "

"eventosRastreio": [

{

"data": "2025-08-11T05:16:00",

"status": "CHEGADA NA FILIAL DESTINO",

"codigoOcorrencia": "98",

"localOrigem": {

"cidade": "SAO JOAO DE MERITI",

"uf": "RJ"

RODONAVES

É realizado um cálculo da previsão de dias a partir da data de emissão

{"ProtocolNumber":"199270427",

"BillOfLadingId":114251231,

"CTeNumber":"54545302",

"SenderDescription":"D.S. SCHIAVETTO E CIA LTDA.",

"SenderTaxIdRegistration":"05819698000195",

"RecipientDescription":"AUTO PECAS PRIMOS DE FRANCA LTDA EPP",

"RecipientTaxIdRegistration":"05034428000179",

"ExpectedDeliveryDays":1,

"EmissionDate":"2025-08-08T17:35:26-03:00",

"FiscalDocumentNumber":"000158348",

"ListFiscalDocument":[],

"SerialCTE":"1",

"UnitEmi":"620",

"Events":[{"Date":"2025-08-08T17:35:26-03:00"

TNT

<?xml version='1.0' encoding='UTF-8'?>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

    <S:Body>

        <ns0:localizaMercadoriaResponse xmlns:ns0="http://service.localizacao.mercurio.com" xmlns:ns1="http://model.localizacao.mercurio.com">

            <ns0:out>

                <localizacao>ENTREGA REALIZADA  </localizacao>

            </ns0:out>

        </ns0:localizaMercadoriaResponse>

    </S:Body>

</S:Envelope>

Pontos de Entrada utilizados:

Não se aplica

Cadastro de SCHEDULE:

Interface gráfica do usuário, Texto, Aplicativo
O conteúdo gerado por IA pode estar incorreto.

Interface gráfica do usuário, Aplicativo
O conteúdo gerado por IA pode estar incorreto.

Se quiser saber mais sobre este ou outro procedimento, fale com a gente!