{"info":{"_postman_id":"4b16f4bb-3a1f-4cc2-b666-3ce081db7a81","name":"Manual Apps Logística","description":"

O manual abaixo explica como funciona o padrão de integração da Webstore com empresas de logística.

São descritos quatro etapas fundamentais para o funcionamento de uma integração, sendo elas:

Autenticação e verificação de tokens da integração;
Consulta de valores e prazos de fretes;
Criação de envios e etiquetas;
Rastreamento de envios;

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"1017532","collectionId":"4b16f4bb-3a1f-4cc2-b666-3ce081db7a81","publishedId":"UyrDEw8Z","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-04-27T13:33:11.000Z"},"item":[{"name":"Autenticação","id":"4c531836-3b16-485e-9392-74ceb3fb59ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"tokens\": [\r\n {\r\n \"id\": \"client_id\",\r\n \"valor\": \"c36db133-6399-390c-b400-6ce046ed9255\"\r\n },\r\n {\r\n \"id\": \"access_token\",\r\n \"valor\": \"02d6d474-83f5-38ab-ba25-81fa62ee614b\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/confirm","description":"

Etapa responsável por validar os tokens de integração

\n","urlObject":{"protocol":"http","path":["confirm"],"host":["aplicacao-satelite"],"query":[],"variable":[]}},"response":[{"id":"feacb527-4d28-48ca-8442-071337780565","name":"Autenticação","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"tokens\": [\r\n {\r\n \"id\": \"client_id\",\r\n \"valor\": \"c36db133-6399-390c-b400-6ce046ed9255\"\r\n },\r\n {\r\n \"id\": \"access_token\",\r\n \"valor\": \"02d6d474-83f5-38ab-ba25-81fa62ee614b\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/confirm"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"sucesso\": true,\r\n \"mensagem\": \"Tokens válidos\",\r\n \"validade\": null\r\n}"}],"_postman_id":"4c531836-3b16-485e-9392-74ceb3fb59ae"},{"name":"Cálculo de frete","id":"8d28cdd9-289d-48bf-b414-d78822f8e9b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"tokens\": \"string com tokens salvo no auth\",\r\n \"from\": {\r\n \"postal_code\": \"96020360\"\r\n },\r\n \"to\": {\r\n \"postal_code\": \"01018020\"\r\n },\r\n \"products\": [\r\n {\r\n \"id\": \"x\",\r\n \"width\": 11,\r\n \"height\": 17,\r\n \"length\": 11,\r\n \"weight\": 0.3,\r\n \"cost\": 10.1,\r\n \"quantity\": 1\r\n },\r\n {\r\n \"id\": \"y\",\r\n \"width\": 16,\r\n \"height\": 25,\r\n \"length\": 11,\r\n \"weight\": 0.3,\r\n \"cost\": 55.05,\r\n \"quantity\": 2\r\n },\r\n {\r\n \"id\": \"z\",\r\n \"width\": 22,\r\n \"height\": 30,\r\n \"length\": 11,\r\n \"weight\": 1,\r\n \"cost\": 30,\r\n \"quantity\": 1\r\n }\r\n ],\r\n \"volume\":{\r\n \"height\": 15,\r\n \"width\": 20,\r\n \"length\": 10,\r\n \"weight\": 3.5\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/shipment/calculate","description":"

Etapa responsável por receber os dados do carrinho de compras e criar uma cotação retornando os possíveis métodos de envio, seus valores e prazos.

\n","urlObject":{"protocol":"http","path":["shipment","calculate"],"host":["aplicacao-satelite"],"query":[],"variable":[]}},"response":[{"id":"60230441-55a4-4855-9a7c-cf5be2ec80bf","name":"Cálculo de frete","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"tokens\": \"string com tokens salvo no auth\",\r\n \"from\": {\r\n \"postal_code\": \"96020360\"\r\n },\r\n \"to\": {\r\n \"postal_code\": \"01018020\"\r\n },\r\n \"products\": [\r\n {\r\n \"id\": \"x\",\r\n \"width\": 11,\r\n \"height\": 17,\r\n \"length\": 11,\r\n \"weight\": 0.3,\r\n \"cost\": 10.1,\r\n \"quantity\": 1\r\n },\r\n {\r\n \"id\": \"y\",\r\n \"width\": 16,\r\n \"height\": 25,\r\n \"length\": 11,\r\n \"weight\": 0.3,\r\n \"cost\": 55.05,\r\n \"quantity\": 2\r\n },\r\n {\r\n \"id\": \"z\",\r\n \"width\": 22,\r\n \"height\": 30,\r\n \"length\": 11,\r\n \"weight\": 1,\r\n \"cost\": 30,\r\n \"quantity\": 1\r\n }\r\n ],\r\n \"volume\":{\r\n \"height\": 15,\r\n \"width\": 20,\r\n \"length\": 10,\r\n \"weight\": 3.5\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/shipment/calculate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 27 Apr 2022 13:01:06 GMT"},{"key":"Content-Type","value":"text/html; charset=UTF-8"},{"key":"Content-Length","value":"115008"},{"key":"Connection","value":"keep-alive"},{"key":"X-Served-From","value":"Show Services"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"Wed, 27 Apr 2022 13:01:15 GMT"},{"key":"Cache-Control","value":"max-age=10"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Request-Id","value":"5f50a734-879b-401d-9f47-3f22a93909a7"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Mobile","value":"desktop"},{"key":"Show-Page-Version","value":"0"},{"key":"Age","value":"1"},{"key":"Vary","value":"X-Forwarded-Proto, Accept-Encoding, User-Agent, Wall-Subscription-Level"},{"key":"X-Bip","value":"513005498 ra09 20 13"},{"key":"Via","value":"2.0 CachOS"},{"key":"Accept-Ranges","value":"bytes"},{"key":"X-Thanos","value":"0AB4D020"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"XXXXXXX\",\n \"name\": \"SEDEX\",\n \"price\": 12.00,\n \"delivery_time\": 3\n },\n {\n \"id\": \"YYYYY\",\n \"name\": \"PAC\",\n \"price\": 11.00,\n \"delivery_time\": 5\n }\n]"}],"_postman_id":"8d28cdd9-289d-48bf-b414-d78822f8e9b5"},{"name":"Gerar etiqueta","id":"46324025-d886-48cf-95b3-ff0ff4357964","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"tokens\": \"string com tokens salvo no auth\",\n \"service\": \"XXXXXX\",\n \"order_number\": \"000123\",\n \"order_value\": 1000.00,\n \"from\": {\n \"type\": \"PF\",\n \"name\": \"Luke Skywalker\",\n \"phone\": \"1199999999\",\n \"email\": \"contato@theforce.com.br\",\n \"document\": \"00000000000\",\n \"address\": \"Endereço do remetente\",\n \"complement\": \"Complemento\",\n \"number\": \"1\",\n \"district\": \"Bairro\",\n \"state\": \"SP\",\n \"city\": \"São Paulo\",\n \"country_id\": \"BR\",\n \"postal_code\": \"01002001\"\n },\n \"to\": {\n \"type\": \"PF\",\n \"name\": \"Nome do destinatário\",\n \"phone\": \"1199999999\",\n \"email\": \"contato@gmail.com\",\n \"document\": \"00000000000\",\n \"address\": \"Endereço do destinatário\",\n \"complement\": \"Complemento\",\n \"number\": \"2\",\n \"district\": \"Bairro\",\n \"city\": \"Porto Alegre\",\n \"state\": \"RS\",\n \"country_id\": \"BR\",\n \"postal_code\": \"90570020\"\n },\n \"products\": [\n {\n \"name\": \"Papel adesivo para etiquetas 1\",\n \"quantity\": 3,\n \"unitary_value\": 100.00,\n \"width\": 11,\n \"height\": 17,\n \"length\": 11,\n \"weight\": 0.3\n },\n {\n \"name\": \"Papel adesivo para etiquetas 2\",\n \"quantity\": 1,\n \"unitary_value\": 700.00,\n \"width\": 11,\n \"height\": 17,\n \"length\": 11,\n \"weight\": 0.3\n }\n ],\n \"volume\":{\n \"height\": 15,\n \"width\": 20,\n \"length\": 10,\n \"weight\": 3.5\n },\n \"options\": {\n \"invoice\": {\n \"key\": \"99999999999999999999999999999999999999\",\n \"number\": \"123456\",\n \"serie\": \"1\"\n }\n }\n}"},"url":"http://aplicacao-satelite/shipment/post","description":"

Etapa responsável por receber os dados do pedido e criar uma etiqueta de envio do pedido.

\n","urlObject":{"protocol":"http","path":["shipment","post"],"host":["aplicacao-satelite"],"query":[],"variable":[]}},"response":[{"id":"1406442d-5a59-4d8e-9c34-9338f24c36de","name":"Gerar etiqueta","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"tokens\": \"string com tokens salvo no auth\",\n \"service\": \"XXXXXX\",\n \"order_number\": \"000123\",\n \"order_value\": 1000.00,\n \"from\": {\n \"type\": \"PF\",\n \"name\": \"Luke Skywalker\",\n \"phone\": \"1199999999\",\n \"email\": \"contato@theforce.com.br\",\n \"document\": \"00000000000\",\n \"address\": \"Endereço do remetente\",\n \"complement\": \"Complemento\",\n \"number\": \"1\",\n \"district\": \"Bairro\",\n \"state\": \"SP\",\n \"city\": \"São Paulo\",\n \"country_id\": \"BR\",\n \"postal_code\": \"01002001\"\n },\n \"to\": {\n \"type\": \"PF\",\n \"name\": \"Nome do destinatário\",\n \"phone\": \"1199999999\",\n \"email\": \"contato@gmail.com\",\n \"document\": \"00000000000\",\n \"address\": \"Endereço do destinatário\",\n \"complement\": \"Complemento\",\n \"number\": \"2\",\n \"district\": \"Bairro\",\n \"city\": \"Porto Alegre\",\n \"state\": \"RS\",\n \"country_id\": \"BR\",\n \"postal_code\": \"90570020\"\n },\n \"products\": [\n {\n \"name\": \"Papel adesivo para etiquetas 1\",\n \"quantity\": 3,\n \"unitary_value\": 100.00,\n \"width\": 11,\n \"height\": 17,\n \"length\": 11,\n \"weight\": 0.3\n },\n {\n \"name\": \"Papel adesivo para etiquetas 2\",\n \"quantity\": 1,\n \"unitary_value\": 700.00,\n \"width\": 11,\n \"height\": 17,\n \"length\": 11,\n \"weight\": 0.3\n }\n ],\n \"volume\":{\n \"height\": 15,\n \"width\": 20,\n \"length\": 10,\n \"weight\": 3.5\n },\n \"options\": {\n \"invoice\": {\n \"key\": \"99999999999999999999999999999999999999\",\n \"number\": \"123456\",\n \"serie\": \"1\"\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/shipment/post"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"success\": true,\r\n \"msg\": \"Etiqueta gerada com sucesso\",\r\n \"url\": \"http://url_de_rastreamento\",\r\n \"url_buy\": \"https://url_pagina_compra_etiqueta\",\r\n \"id\": \"id_do_envio\"\r\n}"}],"_postman_id":"46324025-d886-48cf-95b3-ff0ff4357964"},{"name":"Imprimir etiqueta","id":"4e74d984-e795-4a51-a2ad-098c9fb5db37","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"tokens\": \"string com tokens salvo no auth\",\n}"},"url":"http://aplicacao-satelite/shipment/print/{id}","description":"

Etapa responsável por receber os dados do pedido e criar uma etiqueta de envio do pedido.

\n","urlObject":{"protocol":"http","path":["shipment","print","{id}"],"host":["aplicacao-satelite"],"query":[],"variable":[]}},"response":[{"id":"872cf117-313a-4980-83f8-8a830449a6d5","name":"Imprimir etiqueta","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"tokens\": \"string com tokens salvo no auth\"\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/shipment/print/{id}"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"success\": true,\r\n \"msg\": \"Etiqueta gerada com sucesso\",\r\n \"url\": \"http://url_de_visualizacao_da_etiqueta\",\r\n \"psf\": \"base64_do_pdf\"\r\n}"}],"_postman_id":"4e74d984-e795-4a51-a2ad-098c9fb5db37"},{"name":"Rastrear envio","id":"09e336cd-f26a-48fa-8965-a5ef8f111358","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"tokens\": \"string com tokens salvo no auth\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/shipment/track/{id}","description":"

Etapa responsável por receber o ID do envio e retornar seu status, url de rastreio e o follow up do pedido com as mudanças de status.

\n","urlObject":{"protocol":"http","path":["shipment","track","{id}"],"host":["aplicacao-satelite"],"query":[],"variable":[]}},"response":[{"id":"789b4ccf-21dd-4b7b-8ecd-344757041ba7","name":"Cálculo de frete","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"tokens\": \"string com tokens salvo no auth\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://aplicacao-satelite/shipment/track/{id}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 27 Apr 2022 13:01:06 GMT"},{"key":"Content-Type","value":"text/html; charset=UTF-8"},{"key":"Content-Length","value":"115008"},{"key":"Connection","value":"keep-alive"},{"key":"X-Served-From","value":"Show Services"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"Wed, 27 Apr 2022 13:01:15 GMT"},{"key":"Cache-Control","value":"max-age=10"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Request-Id","value":"5f50a734-879b-401d-9f47-3f22a93909a7"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Mobile","value":"desktop"},{"key":"Show-Page-Version","value":"0"},{"key":"Age","value":"1"},{"key":"Vary","value":"X-Forwarded-Proto, Accept-Encoding, User-Agent, Wall-Subscription-Level"},{"key":"X-Bip","value":"513005498 ra09 20 13"},{"key":"Via","value":"2.0 CachOS"},{"key":"Accept-Ranges","value":"bytes"},{"key":"X-Thanos","value":"0AB4D020"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"msg\": \"\",\n \"status\": \"enviado|em trânsito|entregue|outros\",\n \"url\": \"url_de_rastreamento\",\n \"url_buy\": \"url_de_compra\",\n \"process\":[\n {\n \"date\":\"2022-04-29 15:00\",\n \"status\": \"Enviado a transportadora\"\n },\n {\n \"date\":\"2022-04-29 16:00\",\n \"status\": \"Processando\"\n },\n {\n \"date\":\"2022-04-29 18:00\",\n \"status\": \"Entregue\"\n }\n ]\n}"}],"_postman_id":"09e336cd-f26a-48fa-8965-a5ef8f111358"}]}