{"info":{"_postman_id":"1d78dbdf-41d6-4743-83b2-b01df9ad8584","name":"Find My Pack - Integrações","description":"

Seja muito bem vindo à Documentação Oficial de integração da Find My Pack, ferramenta de automações logísticas para e-commerce.

Se você ainda não nos conhece, por favor, visite www.findmypack.com.br.

Conheça também as duas outras soluções do grupo: www.troqueedevolva.com.br e www.linkderastreio.com.br

ATENÇÃO: Se você está buscando a API do transportador, primeiramente entre em contato conosco para que possamos credenciá-lo e liberar suas credenciais. Somente depois disso enviaremos a documentação de integração para transportadores.

Autenticação

Você precisará enviar token e key no header para autenticar a sua requisição.

O Assinante Find My Pack tem acesso às suas credenciais acessando nosso Painel => Integrações.

Limite de requisições

Cada token pode realizar até 20 requisições por segundo.

Precisa de ajuda?

Nossa equipe de desenvolvedores estão à disposição para tirar todas as suas dúvidas de integração.

Você pode escrever para csm@findmypack.com.br ou utilizar o Chat Online no Painel Find My Pack.

Não esqueça de entrar em contato e solicitar a homologação de sua aplicação. Isso lhe garantirá a exposição da sua marca e contato em nosso site oficial como parceiro integrador.

Não tem quem desenvolva sua integração? Entre em contato que indicaremos um profissional de confiança.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"3840761","collectionId":"1d78dbdf-41d6-4743-83b2-b01df9ad8584","publishedId":"TzXzDckV","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2021-06-09T00:08:37.000Z"},"item":[{"name":"Objetos","item":[{"name":"Entrega Correios","id":"5a272891-845f-4f07-aaad-f5b9abb41ae7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"seu_token","description":"

Token obtido no Painel Find My Pack

\n","type":"text"},{"key":"key","value":"sua_key","description":"

Key obtida no Painel Find My Pack.

\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"ob_integracao\": \"O nome de sua plataforma ou do integrador\", \r\n \"ob_transportadora_codigo\": \"1\", \r\n \"ob_codigo_rastreio\": \"PG123456510BR\", \r\n \"ob_pedido\": \"8888\", \r\n \"ob_cep\": \"81250050\", \r\n \"ob_cep_destino\": \"28-250-280\", \r\n \"ob_destinatario\": \"Cliente Paulo Silva\", \r\n \"ob_destinatario_endereco\": \"Rua do Endereco\",\r\n \"ob_destinatario_numero\": \"38\", \r\n \"ob_destinatario_complemento\": \"\", \r\n \"ob_destinatario_bairro\": \"Bairro\", \r\n \"ob_destinatario_cidade\": \"Bairro\", \r\n \"ob_destinatario_estado\": \"ufff\", \r\n \"ob_destinatario_telefone\": \"4188888888\", \r\n \"ob_notafiscal_numero\": \"85258\", \r\n \"ob_notafiscal_serie\": \"1\", \r\n \"ob_notafiscal_id\": \"99999999999999999999999999999999999999999999\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://publica.apifmp.com.br/objetos","description":"

Para cadastrar uma nova entrega dos Correios, você deve realizar o envio das informações necessárias pelo método POST.

\n","urlObject":{"protocol":"https","path":["objetos"],"host":["publica","apifmp","com","br"],"query":[],"variable":[]}},"response":[],"_postman_id":"5a272891-845f-4f07-aaad-f5b9abb41ae7"},{"name":"Entrega de transportadora por ID","id":"6efd3da2-b00a-471b-8367-9566ccc48c7a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"seu_token","description":"

Token obtido no Painel Find My Pack

\n","type":"text"},{"key":"key","value":"sua_key","description":"

Key obtida no Painel Find My Pack.

\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n //QUEM ESTÁ DESENVOLVENDO?\r\n \"ob_integracao\": \"O nome de sua plataforma ou do integrador\", // Para sabermos quem desenvolveu esssa integração.\r\n //DADOS DA ENTREGA\r\n \"ob_transportadora_codigo\": \"2\", //Código da transportadora na Find My Pack. Veja a listagem na descrição do tópico.\r\n \"ob_codigo_rastreio\": \"1800255222211\", \r\n \"ob_cep\": \"81250050\", // CEP do remetente/origem da entrega \r\n //ENDEREÇO DE ENTREGA\r\n \"ob_cep_destino\": \"81250050\", \r\n \"ob_destinatario\": \"Cliente Paulo Silva\", \r\n \"ob_destinatario_endereco\": \"Rua do Endereco\", \r\n \"ob_destinatario_numero\": \"38\", \r\n \"ob_destinatario_complemento\": \"\", // OPCIONAL\r\n \"ob_destinatario_bairro\": \"Bairro\", \r\n \"ob_destinatario_cidade\": \"Cidade\", \r\n \"ob_destinatario_estado\": \"PR\", \r\n \"ob_destinatario_email\": \"email@cliente.com.br\", //OPCIONAL - É utilizado para enviar comunicações da entrega. Sem o e-mail os avisos automáticos sobre atualização da entrega não serão disparados.\r\n \"ob_destinatario_telefone\": \"4188888888\", //OPCIONAL - É utilizado para envio de SMS/Whastapp. Sem o número de celular, comunicações por SMS e Whatsapp não serão disparados.\r\n //NOTA FISCAL\r\n \"ob_notafiscal_numero\": \"85258\", // Número da nota fiscal é obrigatório para transportadoras.\r\n \"ob_notafiscal_serie\": \"1\", //Número de série da nota fiscal é obrigatório para transportadoras.\r\n \"ob_notafiscal_id\": \"99999999999999999999999999999999999999999999\" // Chave de 44 dígitos da nota fiscal que consta na DANFE\r\n}","options":{"raw":{"language":"json"}}},"url":"https://publica.apifmp.com.br/objetos","description":"

Para cadastrar uma nova entrega de transportadora na qual você consiga saber qual o código antecipadamente, você deve realizar o envio das informações necessárias pelo método POST.

ID´s de transportadora:

1 Correios
2 Jadlog
3 Rodonaves
4 Tam
5 Jamef
6 Now Log
7 TNT
8 Atlas
10 Braspress
11 Lema Rezende
13 Total Express
14 Rede Sul
15 Carriers
16 Diretalog
17 FM Transportes
18 Retirada na Loja
19 Transfolha
20 Dia Entregue
21 Bravo Transportes
22 JR Transportes
23 DHL Transportes
24 Sylog
25 Yellow
26 Dimensão
27 J & T
28 FastVia
29 Entrega Local
30 Gol Log
31 Smart2C
32 Loggi
33 Mandae
34 SpryLog
35 Amazonas Express
36 TW Transportes
37 Expresso São Miguel
38 DBA Express
39 Azul Cargo
40 Smart Envios
41 Melhor Envio
42 Is Entrega
43 Translovato
44 Camillo dos Santos
45 Daytona
46 Disk & Tenha
47 Via Pajuçara
48 Expresso Leomar
49 Kangu

\n","urlObject":{"protocol":"https","path":["objetos"],"host":["publica","apifmp","com","br"],"query":[],"variable":[]}},"response":[],"_postman_id":"6efd3da2-b00a-471b-8367-9566ccc48c7a"},{"name":"Entrega de transportadora por TAG","id":"9db887fb-8556-49bc-963c-74f630c1af80","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"token","value":"seu_token","description":"

Token obtido no Painel Find My Pack

\n","type":"text"},{"key":"key","value":"sua_key","description":"

Key obtida no Painel Find My Pack.

\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n //QUEM ESTÁ DESENVOLVENDO?\r\n \"ob_integracao\": \"O nome de sua plataforma ou do integrador\", // Para sabermos quem desenvolveu esssa integração.\r\n //TAG DA TRANSPORTADORA\r\n \"ob_transportadora_tag\": \"TRANSPORTES FMP LTDA\", // Tag que identifique qual a transportadora desta entrega. O Assinante Find My Pack deverá configurar a mesma tag de forma idêntica e vincular à uma das transportadoras em nosso Painel.\r\n //DADOS DA ENTREGA\r\n \"ob_codigo_rastreio\": \"1800255222211\", \r\n \"ob_cep\": \"81250050\", // CEP do remetente/origem da entrega \r\n //ENDEREÇO DE ENTREGA\r\n \"ob_cep_destino\": \"81250050\", \r\n \"ob_destinatario\": \"Cliente Paulo Silva\", \r\n \"ob_destinatario_endereco\": \"Rua do Endereco\", \r\n \"ob_destinatario_numero\": \"38\", \r\n \"ob_destinatario_complemento\": \"\", // OPCIONAL\r\n \"ob_destinatario_bairro\": \"Bairro\", \r\n \"ob_destinatario_cidade\": \"Cidade\", \r\n \"ob_destinatario_estado\": \"PR\", \r\n \"ob_destinatario_email\": \"email@cliente.com.br\", //OPCIONAL - É utilizado para enviar comunicações da entrega. Sem o e-mail os avisos automáticos sobre atualização da entrega não serão disparados.\r\n \"ob_destinatario_telefone\": \"4188888888\", //OPCIONAL - É utilizado para envio de SMS/Whastapp. Sem o número de celular, comunicações por SMS e Whatsapp não serão disparados.\r\n //NOTA FISCAL\r\n \"ob_notafiscal_numero\": \"85258\", // Número da nota fiscal é obrigatório para transportadoras.\r\n \"ob_notafiscal_serie\": \"1\", //Número de série da nota fiscal é obrigatório para transportadoras.\r\n \"ob_notafiscal_id\": \"99999999999999999999999999999999999999999999\" // Chave de 44 dígitos da nota fiscal que consta na DANFE\r\n}","options":{"raw":{"language":"json"}}},"url":"https://publica.apifmp.com.br/objetos","description":"

Para cadastrar uma nova entrega de transportadora que não seja possível enviar o código, há possibilidade de enviar o nome dela e vincular este nome com uma transportadora em nosso painel. Isso é útil para quando você tiver diversos nomes diferentes para uma mesma transportadora.

Exemplo: se você estiver integrando uma plataforma de e-commerce e não tiver um nome único para determinada transportadora, ou seja, um lojista dá o nome de TRANSPORTADORA ABC e outro ABC TRANSPORTES, será praticamente impossível que você nos informe o código da transportadora.

Você pode então apenas enviar o campo ob_transportadora_tag e o Assinante Find My Pack cadastrará o nome TRANSPORTADORA ABC e irá vincular à transportadora correspondente.

\n","urlObject":{"protocol":"https","path":["objetos"],"host":["publica","apifmp","com","br"],"query":[],"variable":[]}},"response":[],"_postman_id":"9db887fb-8556-49bc-963c-74f630c1af80"},{"name":"Pesquisar envios","id":"6bff593d-4f78-4feb-9947-da2665402b7b","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"token","value":"seu_token","description":"

Token obtido no Painel Find My Pack

\n","type":"text"},{"key":"key","value":"sua_key","description":"

Key obtida no Painel Find My Pack.

\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://publica.apifmp.com.br/objetos?ob_destinatario=ana maria","description":"

Você pode realizar a pesquisa com quaisquer campos que forem necessários. Listamos os mais utilizados e exemplos de preenchimento, para que você escolha quais quer utilizar em sua pesquisa.

Principais ID´s de andamento de entrega:

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

ID	Andamento
99	postado
1	em curso
11	saiu para entrega
12	destinatário ausente
21	entregue no prazo
22	entregue fora do prazo
34	extraviado

","urlObject":{"protocol":"http","path":["objetos"],"host":["publica","apifmp","com","br"],"query":[{"disabled":true,"description":{"content":"

ob_data é o campo de data-hora de cadastro. >= (maior ou igual)

\n","type":"text/plain"},"key":"ob_data","value":">=2020-04-28 00:00:01"},{"disabled":true,"description":{"content":"

ob_data é o campo de data-hora de cadastro. <= (menor ou igual)

\n","type":"text/plain"},"key":"ob_data","value":"<=2020-04-30 23:59:59"},{"disabled":true,"description":{"content":"

Por data de previsão de entrega.

\n","type":"text/plain"},"key":"ob_data_previsao","value":">=2020-04-28 00:00:01"},{"disabled":true,"description":{"content":"

Por data de previsão de entrega.

\n","type":"text/plain"},"key":"ob_data_previsao","value":"<=2020-04-30 23:59:59"},{"disabled":true,"description":{"content":"

Por data de entrega.

\n","type":"text/plain"},"key":"ob_data_entrega","value":">=2020-04-28 00:00:01"},{"disabled":true,"description":{"content":"

Por data de entrega.

\n","type":"text/plain"},"key":"ob_data_entrega","value":"<=2020-04-30 23:59:59"},{"disabled":true,"description":{"content":"

ID de status da entrega. Consulte a lista.

\n","type":"text/plain"},"key":"ob_status","value":"11"},{"disabled":true,"description":{"content":"

Por ID de transportadora. Consulte a lista.

\n","type":"text/plain"},"key":"ob_transportadora_codigo","value":"1"},{"disabled":true,"description":{"content":"

E-mail do destinatário

\n","type":"text/plain"},"key":"ob_destinatario_email","value":"email@anamaria.com.br"},{"disabled":true,"description":{"content":"

Código de rastreio

\n","type":"text/plain"},"key":"ob_codigo_rastreio","value":"PG111444555BR"},{"disabled":true,"description":{"content":"

Número da NF

\n","type":"text/plain"},"key":"ob_notafiscal_numero","value":"85555"},{"disabled":true,"description":{"content":"

Número do pedido

\n","type":"text/plain"},"key":"ob_pedido","value":"5822"},{"disabled":true,"description":{"content":"

Quantos resultados por página. O máximo é 100.

\n","type":"text/plain"},"key":"limit","value":"100"},{"disabled":true,"description":{"content":"

Qual página você quer retornar.

\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"key":"sta_id","value":"21"},{"disabled":true,"key":"sta_id","value":"22"},{"key":"ob_destinatario","value":"ana maria"}],"variable":[]}},"response":[],"_postman_id":"6bff593d-4f78-4feb-9947-da2665402b7b"},{"name":"Obter um envio por ID","id":"f17be0f7-794f-49ad-a86d-d5ef7384d2a1","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"token","value":"seu_token","description":"

Token obtido no Painel Find My Pack

\n","type":"text"},{"key":"key","value":"sua_key","description":"

Key obtida no Painel Find My Pack.

\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://publica.apifmp.com.br/objetos/ob_id","description":"

Para obter o detalhamento de um objeto no qual você saiba o ob_id.

\n","urlObject":{"protocol":"https","path":["objetos","ob_id"],"host":["publica","apifmp","com","br"],"query":[],"variable":[]}},"response":[],"_postman_id":"f17be0f7-794f-49ad-a86d-d5ef7384d2a1"},{"name":"Editar um envio por ID","id":"11eb31bd-a4b0-4cf7-9525-792deb6652aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"token","value":"seu_token","description":"

Token obtido no Painel Find My Pack

\n","type":"text"},{"key":"key","value":"sua_key","description":"

Key obtida no Painel Find My Pack.

\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"ob_destinatario\": \"Nome alterado\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://publica.apifmp.com.br/objetos/ob_id","description":"

Para atualizar um objeto, você deve informar o ob_id.

Os campos somente leitura retornarão um erro de edição. Você pode saber o nome dos campos disponíveis realizando uma consulta de seu objeto por ob_id.

A entrada /objetos é responsável por cadastrar, editar e pesquisar entregas na plataforma da Find My Pack.

\n","_postman_id":"48a02ce0-66ae-4a3c-ac69-3b21185921b6"}],"event":[{"listen":"prerequest","script":{"id":"1deffc92-328a-4608-960d-381a3b248f49","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b04c0b73-135e-4947-8866-62b4c0e5cc86","type":"text/javascript","exec":[""]}}],"variable":[{"key":"token","value":"seu_token"},{"key":"key","value":"sua_key"},{"key":"ob_id","value":"ob_id"}]}