Integração Jamef e-commerce Rastreamento de carga via de requisição na web 1. Objetivo Disponibilizar o rastreamento de carga de forma fácil e integrada para os nossos clientes que vendem seus produtos por meio de comércio eletrônico (e-commerce). 2. Funcionamento Para disponibilizar o rastreamento de carga em seu site, o sistema do cliente deverá fazer uma chamada interna ao link conforme seus parâmetros: http://www.jamef.com.br/e-commerce/rastreamentocargaservlet Parâmetro Obrigatório Descrição CIC_RESP_PGTO Sim CNPJ do cliente que será responsável pelo pagamento CIC_DEST Sim CNPJ do cliente de destino NUM_NF Sim Número da nota fiscal do produto SERIE_NF Não Número de série da nota fiscal do produto SAIDA Não Tipo de arquivo de saída, sendo HTML ou XML. Se não for informado o sistema era gerar o XML. COD_REGN_ORIG Não Código da filial Jamef que coletará a mercadoria Fique atento! Na maioria dos casos, este parâmetro será sempre a filial de atendimento. Porém será necessário verificar a filial de coleta caso o cliente possua mais de um local de armazenagem e expedição de sua mercadoria. Exemplo do link com parâmetros fictícios: http://www.jamef.com.br/e-commerce/rastreamentocargaservlet?cic_resp_pgto=99999999999999&cic_dest= 99999999999999&COD_REGN_ORIG=02&NUM_NF=9999&SERIE_NF=99&SAIDA=HTML Verifique abaixo os códigos das filiais Jamef: Filial Localização Código AJU Aracaju/ SE 31 BAR Barueri / SP 19 BAU Bauru / SP 16 BHZ Belo Horizonte / MG 02 BNU Blumenau / SC 09 BSB Brasília / DF 28 CCM Criciúma / SC 26 CPQ Campinas / SP 03 CXJ Caxias do Sul / RS 22 CWB Curitiba / PR 04 DIV Divinópolis / MG 38 FES Feira de Santana / BA 34 FLN Florianópolis / SC 11 FOR Fortaleza / CE 32 GYN Goiânia / GO 24 JPA João Pessoa / PB 36
JDF Juiz de Fora / MG 23 JOI Joinville / SC 08 LDB Londrina / PR 10 MAO Manaus / AM 25 MCZ Maceió / AL 33 MGF Maringá / PR 12 POA Porto Alegre / RS 05 PSA Pouso Alegre / MG 27 RAO Ribeirão Preto / SP 18 REC Recife / PE 30 RIO Rio de Janeiro / RJ 06 SAO São Paulo / SP 07 SJK São José dos Campos / SP 21 SJP São José do Rio Preto / SP 20 SSA Salvador / BA 29 UDI Uberlândia / MG 17 VDC Vitória da Conquista / BA 39 VIX Vitória / ES 14 3. Resultados Após execução do link, será retornado o arquivo conforme formato solicitado. Veja abaixo os exemplos: Arquivo HTML tela Jamef
Arquivo XML retorno no caso de sucesso da consulta. O responsável pelo site do cliente deverá desenvolver uma rotina de integração para ler este retorno e carregá-lo na página da loja virtual. <?xml version="1.0" encoding="iso-8859-1"?> <RASTREAMENTO> <CONHECIMENTO> <CTRC>999999999</CTRC> <NF>999999</NF> <CLIORIG>JAMEF ENCOMENDAS URGENTES</CLIORIG> <MUNORIG>BELO HORIZONTE</MUNORIG> <UFORIG>MG</UFORIG> <CLIDEST>JAMEF ENCOMENDAS URGENTES</CLIDEST> <MUNDEST>SAO PAULO</MUNDEST> <UFDEST>SP</UFDEST> <LINKIMG>IMAGEM NAO DISPONIVEL</LINKIMG> </CONHECIMENTO> <HISTORICO> <STATUS>ENTREGA REALIZADA</STATUS> <DTATUALIZ>02/01/2015 09:00</DTATUALIZ> <MUNLOCL>SAO PAULO</MUNLOCL> <UFLOCL>SP</UFLOCL> <STATUS>ENTREGANDO</STATUS> <DTATUALIZ>02/01/2015 08:00</DTATUALIZ> <MUNLOCL>SAO PAULO</MUNLOCL> <UFLOCL>SP</UFLOCL> <STATUS>EM VIAGEM</STATUS> <DTATUALIZ>01/01/2015 09:00</DTATUALIZ> <MUNLOCL>BELO HORIZONTE</MUNLOCL> <UFLOCL>MG</UFLOCL> <STATUS>EMISSÃO DO DOCUMENTO</STATUS> <DTATUALIZ>01/01/2015 08:00</DTATUALIZ> <MUNLOCL>BELO HORIZONTE</MUNLOCL> <UFLOCL>MG</UFLOCL> </HISTORICO> </RASTREAMENTO>
Arquivo XML retorno no caso de erro ou registro não encontrado: O responsável pelo site do cliente deverá desenvolver uma rotina de integração para ler este retorno e carregá-lo na página da loja virtual. Exemplo do retorno com dados fictícios: <RASTREAMENTO> <ERRO> <CICRESPPGTO>99999999999999</CICRESPPGTO> <CICDEST>99999999999999</CICDEST> <CODREGNORIG>1</CODREGNORIG> <NUMNF>9999</NUMNF> <DESCERRO>REGISTRO NAO ENCONTRADO</DESCERRO> </ERRO> </RASTREAMENTO> 4. TAGs Verifique abaixo a descrição das TAGs utilizadas para integração: CTRC Conhecimento do Transporte Rodoviário de Carga <CTRC> Decimal Número do CTRC para rastreamento da carga <NF> Decimal Número da nota fiscal <CLIORIG> Texto Razão Social do cliente de origem da mercadoria <MUNORIG> Texto Município de origem da coleta da mercadoria <UFORIG> Texto Estado de origem da coleta da mercadoria <CLIDEST> Texto Razão Social do cliente de destino da mercadoria <MUNDEST> Texto Município de destino para entrega da mercadoria <UFDEST> Texto Estado de destino da entrega da mercadoria <LINKIMG> Texto Link do arquivo tipo PDF para visualização do CTRC da mercadoria Fique atento! Caso a mercadoria já tenha sido entregue, este link apresentará uma cópia do CTRC com a assinatura do recebedor. Rastreamento da Carga <STATUS> Texto Status da entrega da mercadoria no momento da consulta <DTATUALIZ> Texto Data de atualização do status <MANIF> Decimal Número do manifesto <MUNLOCL> Texto Município no qual se localiza a mercadoria no momento da consulta <UFLOCL> Texto Estado no qual se localiza a mercadoria no momento da consulta <MUNDESTMANF> Texto Município de destino do manifesto <UFDESTMANF> Texto Estado de destino do manifesto
Erro <CICRESPPGTO> Texto CNPJ ou CPF do responsável pelo pagamento <CICDEST> Texto CNPJ ou CPF do cliente de destino <CODREGNORIG> Texto Filial da Jamef responsável pela coleta da mercadoria e emissão do CTRC <NUMNF> Decimal Número da nota fiscal <DESCERRO> Texto Descrição do erro ou mensagem de REGISTRO NÃO ENCONTRADO 5. Suporte Técnico Em caso de dúvidas, entre em contato com a equipe de TI da Jamef: (31) 2102.8904.