{"info":{"_postman_id":"cad36472-4be6-41cf-a5eb-230cdc0f9b90","name":"Hubii API","description":"

Ambientes Disponíveis

\n

Homologação

\n\n

Produção

\n\n

Como Alternar

\n

Embora esta documentação use o ambiente padrão configurado (atualmente Produção), você pode configurar outro ambiente no Postman:

\n
    \n

  1. Importe a collection no Postman.

    \n
    2. \n

  2. Crie ou selecione o ambiente desejado (Homologação ou Produção).

    \n
    3. \n

  3. As variáveis de ambiente, como https://api.hubii.co, serão ajustadas automaticamente.

    \n
    4. \n
\n

Autenticação com API Key

\n

Esta API utiliza API Key como método de autenticação. Todas as requisições feitas aos endpoints protegidos devem incluir uma chave de autenticação no cabeçalho HTTP.

\n

Como configurar a autenticação?

\n
    \n

  1. Receba sua API Key: A equipe responsável fornecerá uma chave exclusiva para cada parceiro homologado.

    \n
    2. \n

  2. Inclua o header: apikey

    \n
    3. \n
\n

Exemplo de Configuração no Postman

\n
    \n

  1. Abra a aba Authorization de sua collection ou requisição no Postman.

    \n
    2. \n

  2. Selecione o tipo de autenticação como API Key.

    \n
    3. \n

  3. Preencha os campos:

    \n\n
    4. \n
\n
\n

Dica: Quando configurada no nível da collection, essa autenticação será aplicada automaticamente a todas as requisições da collection.

\n
\n

Erros Comuns

\n\n

Rate-Limit da API

\n

As rotas de listagem são de 60 requisições por minuto, calculada pelo token, não por hub.

\n\n

As rotas individuais são de 10 requisições por minuto, de novo, calculada por token

\n\n

Exclusivamente a rota de detalhes do pedido está configurada para 30 requisições por minuto

\n\n

Exclusivamente a rota de notificações está configurada para 5 requisições por minuto

\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"34374925","collectionId":"cad36472-4be6-41cf-a5eb-230cdc0f9b90","publishedId":"2sAYBRGEcV","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"2D254D"},"publishDate":"2024-11-21T16:33:52.000Z"},"item":[{"name":"Listagem de pedidos para resposta","id":"2100ed0b-b90e-4965-987c-966ef5c6c5c3","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://api.hubii.co/hubs/:hub_uuid/orders/to-answer","description":"

Este endpoint retorna uma lista de pedidos disponíveis para o Hub aceitar ou não. Cada pedido contém informações básicas, como identificador único (uuid), identificador numérico (id), o valor total do pedido e até quando o pedido ficará disponível para aceite (available_until_at).

\n
\n

Nota: O campo uuid é usado como identificador único do pedido e deve ser utilizado em requisições subsequentes relacionadas ao pedido.

\n
\n","urlObject":{"path":["hubs",":hub_uuid","orders","to-answer"],"host":["https://api.hubii.co"],"query":[],"variable":[{"type":"any","value":"","key":"hub_uuid"}]}},"response":[{"id":"67cdd4ed-b920-4ed8-bd85-01c63aa125bf","name":"[200] Listagem de pedidos para resposta","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/to-answer","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders","to-answer"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"55"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"9"},{"key":"RateLimit-Limit","value":"10"},{"key":"RateLimit-Remaining","value":"9"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:17:05 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"273"},{"key":"X-Kong-Proxy-Latency","value":"184"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"ee558d06e231553a42fbd973c1e83a0d"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 102656,\n \"uuid\": \"71402839-ecb5-4ee0-b73a-331e7bef74f5\",\n \"available_until_at\": \"2024-12-20T10:55:20+00:00\",\n \"total\": 50.55\n },\n {\n \"id\": 102864,\n \"uuid\": \"bccf34dd-5501-4070-a846-926fb9fa02d6\",\n \"available_until_at\": \"2024-12-20T10:55:20+00:00\",\n \"total\": 63.33\n }\n ]\n}"}],"_postman_id":"2100ed0b-b90e-4965-987c-966ef5c6c5c3"},{"name":"Responder pedido","id":"aa76102f-860d-45cb-ab4d-29a2fecb3b6c","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"accept\": false,\n \"details\": [\n {\n \"type\": \"out_of_portfolio\",\n \"message\": null,\n \"item\": \"7fa6c19c-063e-4670-b825-asd\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.hubii.co/hubs/:hub_uuid/orders/:order_uuid/answer","description":"

Este endpoint permite responder positiva ou negativamente a um pedido listado na rota \"Listagem de pedidos para resposta\".

\n
\n

Nota 1: O campo {hubUuid} na URL deve ser substituído pelo identificador único do Hub.
Nota 2: O campo {orderUuid} na URL deve ser substituído pelo identificador único do pedido.

\n
\n

Quando a resposta for negativa accept=false o campo details será obrigatório para informar pelo menos 1 item com motivo para a recusa do pedido.

\n

Os possiveis valores da propriedade details[i].type são:

\n\n","urlObject":{"path":["hubs",":hub_uuid","orders",":order_uuid","answer"],"host":["https://api.hubii.co"],"query":[],"variable":[{"type":"any","value":"","key":"hub_uuid"},{"type":"any","value":"","key":"order_uuid"}]}},"response":[{"id":"99e4004f-a954-4809-a709-af243443e989","name":"[200] Responder pedido positivamente","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"accept\": true\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/answer","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","answer"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"22"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"8"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"8"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:37:39 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"1261"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"c3d55a45ab449b4958b37255173f7c63"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": true,\n \"message\": \"Order answered\"\n }\n}"},{"id":"937764f6-ff8a-4681-8e7c-c60826c1727c","name":"[200] Responder pedido negativamente por não trabalhar com um dos items","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"accept\": false,\n \"details\": [\n {\n \"type\": \"out_of_portfolio\",\n \"message\": null,\n \"item\": \"a933aab6-c880-470b-b3be-2cc5af040263\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/answer","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","answer"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"22"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"8"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"8"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:37:39 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"1261"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"c3d55a45ab449b4958b37255173f7c63"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": true,\n \"message\": \"Order answered\"\n }\n}"},{"id":"95f8ab1a-38e0-49a5-bc43-0523aa88ebf7","name":"[200] Responder pedido negativamente por não ter em estoque um dos items","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"accept\": false,\n \"details\": [\n {\n \"type\": \"out_of_stock\",\n \"message\": null,\n \"item\": \"a933aab6-c880-470b-b3be-2cc5af040263\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/answer","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","answer"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"22"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"8"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"8"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:37:39 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"1261"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"c3d55a45ab449b4958b37255173f7c63"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": true,\n \"message\": \"Order answered\"\n }\n}"},{"id":"3af08c5e-1d6a-4ab6-84c6-cf888ee6a090","name":"[200] Responder pedido negativamente por estoque insuficiente","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"accept\": false,\n \"details\": [\n {\n \"type\": \"quantity_not_enough\",\n \"message\": null,\n \"item\": \"a933aab6-c880-470b-b3be-2cc5af040263\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/answer","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","answer"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"22"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"8"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"8"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:37:39 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"1261"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"c3d55a45ab449b4958b37255173f7c63"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": true,\n \"message\": \"Order answered\"\n }\n}"},{"id":"391120b4-eae5-4f9c-aa9e-03176a5baa02","name":"[200] Responder pedido negativamente por não aceitar o valor do repasse de um dos itens","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"accept\": false,\n \"details\": [\n {\n \"type\": \"price\",\n \"message\": null,\n \"item\": \"a933aab6-c880-470b-b3be-2cc5af040263\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/answer","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","answer"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"22"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"8"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"8"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:37:39 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"1261"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"c3d55a45ab449b4958b37255173f7c63"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": true,\n \"message\": \"Order answered\"\n }\n}"},{"id":"11eaefc3-76fe-4489-a172-db75f084b92b","name":"[422] Responder pedido","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"accept\": false,\r\n \"details\": [\r\n {\r\n \"type\": \"price\",\r\n \"message\": null,\r\n \"item\": \"a933aab6-c880-470b-b3be-2cc5af040263\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/answer","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","answer"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"21"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"9"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"9"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:35:40 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"258"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"26954260301cc67ab1c5237a1a2f3d24"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": false,\n \"error\": \"Order already answered\"\n }\n}"}],"_postman_id":"aa76102f-860d-45cb-ab4d-29a2fecb3b6c"},{"name":"Notificações de Eventos","id":"9fa9913f-09aa-4955-8c2a-ae7c939e9ece","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.hubii.co/notifications","description":"

Este endpoint retorna as atualizações feitas nos pedidos dos hubs que o usuário possui acesso. Utilize o campos type e subtype para entender as atualizações e refletir em seu ERP.

\n

Fluxo do Pedido

\n\"Diagrama%20sequencial%20para%20importacao%20do%20pedido%20e%20faturamento\"\n\n\"Diagrama%20sequencial%20para%20atualização%20de%20pedidos\"\n\n\n\n

Idealmente o pedido seguira os fluxo feliz de aceite (ORDER_CREATED) até a entrega (ORDER_DELIVERY_DELIVERED), mas podem haver corner cases.

\n
    \n

  1. ORDER_CANCELLED_BY_HUB: O hub terá a chance de recusar o pedido - mesmo depois de ter aceito - tanto no painel quanto no endpoint de recusa desta api. Isso acontece para varejistas que visualmente conferem os estoques dos produtos e se enganam ao aceitar um pedido. O pedido não pode ser cancelado pelo hub após a coleta do pedido.

    \n
    2. \n

  2. ORDER_DELIVERY_COURIER_NOT_FOUND: A rede está sem entregadores suficientes. O sistema Hubii ira automaticamente redirecionar para outro parceiro logístico.

    \n
    3. \n

  3. ORDER_DELIVERY_FAILED_TO_DELIVERY: O cliente não estava em casa para receber o pedido ou não atendeu o entregador. A Hubii entrará em contato com o cliente para reagendar o pedido e com o hub para devolução. O sistema Hubii ainda não possui status de retorno, por isso o pedido será tratado pelo suporte. Quando reagendado, o pedido volta ao fluxo de achar outro entregador no novo horário marcado com o cliente ou o pedido é cancelado.

    \n
    4. \n
\n

🚨 Importante: o evento de cancelamento pela Hubii ou Cliente (no fluxo as linhas contínuas em vermelho) o sistema notificará 1 dia após o cancelamento real. Isso acontece para podermos ter certeza da devolução do pedido ao varejo/hub. Seu ERP, quando receber o evento, deve orientar o varejista a cancelar a nota fiscal se já emitida.

\n

🚨 Informações relevantes

\n
    \n

  1. As notificações ficarão disponíveis por 2 dias, depois desse tempo ela será removida da response.

    \n
    2. \n

  2. Para hubs que operam em marketplaces com entrega longas (Mercado Livre, Magalu, Shopee, Livelo), os eventos não contemplam notificação para pedidos que obrigam a geração de nota fiscal e liberação de etiqueta.

    \n
    3. \n

  3. Todo o painel do hub está orientado ao ID do Pedido (order_id), ou seja, disponibilize a visualização deste ID em seu sistema para que o varejista/hub consiga se organizar na gestão de separação e comunicação com o nosso time de suporte.

    \n
    4. \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\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
typesubtypeDescrição
ORDER_CREATEDO pedido foi aceito pelo hub e deve ser integrado ao ERP
ORDER_DELIVERY_UPDATEDORDER_DELIVERY_SEARCHING_COURIERA Hubii começou a busca por motoristas parceiros para fazer a entrega do pedido.
ORDER_DELIVERY_UPDATEDORDER_DELIVERY_COURIER_NOT_FOUNDA Hubii não conseguiu achar um motorista para fazer a entrega do pedido. Quando não houver entregadores disponíveis vamos utilizar outros parceiros ou tentar reagendar o pedido com o cliente. O sistema integrado deve aguardar novas atualizações
ORDER_DELIVERY_UPDATEDORDER_DELIVERY_COURIER_FOUND / ORDER_DELIVERY_PICKING_UPO entregador foi encontrado e está a caminho para coleta do pedido. Os dois eventos representam o mesmo cenário.
ORDER_DELIVERY_UPDATEDORDER_DELIVERY_PICKED_UP / ORDER_DELIVERY_DELIVERINGO entregador já fez a coleta e está à caminho da entrega ao cliente. Os dois eventos representam o mesmo cenário.
ORDER_DELIVERY_UPDATEDORDER_DELIVERY_FAILED_TO_DELIVERYO entregador não conseguiu fazer a entrega. Aguarde novas atualizações, a Hubii tentará entrar em contato com o cliente e se não tiver sucesso o pedido será devolvido à loja. O sistema ainda não tem atualizações de status de devolução.
ORDER_DELIVERY_UPDATEDORDER_DELIVERY_LOSTO pedido foi extraviado. O repasse referente ao pedido ocorrerá normalmente.
ORDER_DELIVERY_UPDATEDORDER_DELIVERY_DELIVEREDO pedido foi entregue ao cliente e concluído.
ORDER_CANCELLEDORDER_CANCELLEDO pedido foi cancelado pelo cliente ou pela hubii, idealmente o ERP deve cancelar a nota fiscal se já gerada.
ORDER_CANCELLEDORDER_CANCELLED_BY_HUBO pedido foi cancelado pelo hub, idealmente o ERP deve cancelar a nota fiscal se já gerada. O cancelamento do hub não gera cancelamento ao cliente, a Hubii redirecionará o pedido a outros parceiros.
\n
","urlObject":{"path":["notifications"],"host":["https://api.hubii.co"],"query":[{"disabled":true,"description":{"content":"

Utilize o UUID do hub para filtrar notificações referentes a ele

\n","type":"text/plain"},"key":"hub_uuids","value":"a93dd09b-4c47-479a-9dca-9fb8026301a6"},{"disabled":true,"description":{"content":"

Para mais de 1 hub, forneça um array de hub_uuids

\n","type":"text/plain"},"key":"hub_uuids[n]","value":"a93dd09b-4c47-479a-9dca-9fb8026301a6"},{"disabled":true,"description":{"content":"

Filtre as notificações pelo seu tipo

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

Para mais de 1 tipo, forneça um array de types

\n","type":"text/plain"},"key":"types[n]","value":"ORDER_DELIVERY_UPDATED"}],"variable":[]}},"response":[{"id":"4ea122a6-a61c-41a1-9851-2a125c3192d7","name":"Notificações sem filtros","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://api.hubii.co/notifications","host":["https://api.hubii.co"],"path":["notifications"],"query":[{"key":"hub_uuids[0]","value":"a93dd09b-4c47-479a-9dca-9fb8026301a6","description":"Utilize o UUID's dos hubs para filtrar notificações referentes a eles. Para mais de 1 hub envie com separação por virgula","disabled":true},{"key":"types[0]","value":"ORDER_CREATED,ORDER_DELIVERY_UPDATE,ORDER_CANCELLED","description":"Filtre as notificações pelo seu tipo. Para mais de 1 tipo envie com separação por virgula.","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 05 Sep 2025 19:31:23 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-ratelimit-remaining-minute","value":"9"},{"key":"x-ratelimit-limit-minute","value":"10"},{"key":"ratelimit-remaining","value":"9"},{"key":"ratelimit-reset","value":"38"},{"key":"ratelimit-limit","value":"10"},{"key":"x-powered-by","value":"Express"},{"key":"etag","value":"W/\"f92-vQDqeTTBSMMFuOt/SQZLfa/TQ5M\""},{"key":"Server","value":"cloudflare"},{"key":"x-kong-upstream-latency","value":"39"},{"key":"x-kong-proxy-latency","value":"32"},{"key":"via","value":"1.1 kong/3.9.1"},{"key":"x-kong-request-id","value":"1e499a7323da6603dad0cd7dcfb2a278"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=RWjTNpOyWLU2jx1FVJVpG4maaZC0x3YyEPxwkFJVD%2BMl7WI4eWzRVENHZmHsjrmiKJwlmvTm6fyvI0S6E5aiHZ5XBqKG61a15Ri%2FXwRJsfgP4J4%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"97a825824f821ce5-GRU"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"notification_uuid\": \"066d19b9-4aef-4b40-941b-d104ab158cd2\",\n \"type\": \"ORDER_CREATED\",\n \"subtype\": null,\n \"order_uuid\": \"356a4241-456b-49a6-8bdc-93f92ddec7f2\",\n \"order_id\": \"146167\",\n \"order_delivery_id\": \"119758\",\n \"hub_uuid\": \"a93dd09b-4c47-479a-9dca-9fb8026301a6\",\n \"date\": \"2025-09-03T21:46:59.000Z\"\n },\n {\n \"notification_uuid\": \"c3bc1f55-fe65-49c5-ac89-fcef38827d41\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_SEARCHING_COURIER\",\n \"order_uuid\": \"356a4241-456b-49a6-8bdc-93f92ddec7f2\",\n \"order_id\": \"146167\",\n \"order_delivery_id\": \"119758\",\n \"hub_uuid\": \"a93dd09b-4c47-479a-9dca-9fb8026301a6\",\n \"date\": \"2025-09-03T21:47:29.000Z\"\n },\n {\n \"notification_uuid\": \"636b4abf-2458-4e5e-a285-4184af2ffdfd\",\n \"type\": \"ORDER_CREATED\",\n \"subtype\": null,\n \"order_uuid\": \"c71af0ac-6d96-4d1f-a59f-a651ce2c4eb8\",\n \"order_id\": \"146199\",\n \"order_delivery_id\": \"119790\",\n \"hub_uuid\": \"a93dd09b-4c47-479a-9dca-9fb8026301a6\",\n \"date\": \"2025-09-04T12:49:40.000Z\"\n },\n {\n \"notification_uuid\": \"09d0613e-50de-4ed0-9383-184a93429275\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_SEARCHING_COURIER\",\n \"order_uuid\": \"c71af0ac-6d96-4d1f-a59f-a651ce2c4eb8\",\n \"order_id\": \"146199\",\n \"order_delivery_id\": \"119790\",\n \"hub_uuid\": \"a93dd09b-4c47-479a-9dca-9fb8026301a6\",\n \"date\": \"2025-09-04T12:49:44.000Z\"\n },\n {\n \"notification_uuid\": \"f8bb9ca5-961c-4bc3-9bf5-2b47452b2f81\",\n \"type\": \"ORDER_CREATED\",\n \"subtype\": null,\n \"order_uuid\": \"571cdfbe-ba9a-4cf2-aaea-45c67b064c88\",\n \"order_id\": \"146265\",\n \"order_delivery_id\": \"119856\",\n \"hub_uuid\": \"a93dd09b-4c47-479a-9dca-9fb8026301a6\",\n \"date\": \"2025-09-04T16:18:40.000Z\"\n },\n {\n \"notification_uuid\": \"d987097a-a097-49c8-8c57-cf302f3efabd\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_COURIER_NOT_FOUND\",\n \"order_uuid\": \"c71af0ac-6d96-4d1f-a59f-a651ce2c4eb8\",\n \"order_id\": \"146199\",\n \"order_delivery_id\": \"119790\",\n \"hub_uuid\": \"a93dd09b-4c47-479a-9dca-9fb8026301a6\",\n \"date\": \"2025-09-04T12:50:59.000Z\"\n },\n {\n \"notification_uuid\": \"35f09ebf-94e4-440f-902e-f74c1f89670c\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_SEARCHING_COURIER\",\n \"order_uuid\": \"571cdfbe-ba9a-4cf2-aaea-45c67b064c88\",\n \"order_id\": \"146265\",\n \"order_delivery_id\": \"119856\",\n \"hub_uuid\": \"a93dd09b-4c47-479a-9dca-9fb8026301a6\",\n \"date\": \"2025-09-04T16:18:44.000Z\"\n },\n {\n \"notification_uuid\": \"07451006-152c-4406-8ae1-f755bff7bdca\",\n \"type\": \"ORDER_CREATED\",\n \"subtype\": null,\n \"order_uuid\": \"b3372551-01d4-4de8-9f1b-d3e0c912992f\",\n \"order_id\": \"146390\",\n \"order_delivery_id\": \"119981\",\n \"hub_uuid\": \"dbe03cf0-c04b-458c-9b68-16af9faaa9ea\",\n \"date\": \"2025-09-05T18:57:59.000Z\"\n },\n {\n \"notification_uuid\": \"883596c5-dbdd-4720-9178-68b13f428e30\",\n \"type\": \"ORDER_CREATED\",\n \"subtype\": null,\n \"order_uuid\": \"b3372551-01d4-4de8-9f1b-d3e0c912992f\",\n \"order_id\": \"146390\",\n \"order_delivery_id\": \"119981\",\n \"hub_uuid\": \"dbe03cf0-c04b-458c-9b68-16af9faaa9ea\",\n \"date\": \"2025-09-05T19:06:53.000Z\"\n },\n {\n \"notification_uuid\": \"0cdd2ae7-4a0e-4480-b1e9-950141be78dd\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_SEARCHING_COURIER\",\n \"order_uuid\": \"b3372551-01d4-4de8-9f1b-d3e0c912992f\",\n \"order_id\": \"146390\",\n \"order_delivery_id\": \"119981\",\n \"hub_uuid\": \"dbe03cf0-c04b-458c-9b68-16af9faaa9ea\",\n \"date\": \"2025-09-05T19:07:35.000Z\"\n },\n {\n \"notification_uuid\": \"95af8726-3833-424d-bb18-0d0c716b4ffa\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_COURIER_FOUND\",\n \"order_uuid\": \"b3372551-01d4-4de8-9f1b-d3e0c912992f\",\n \"order_id\": \"146390\",\n \"order_delivery_id\": \"119981\",\n \"hub_uuid\": \"dbe03cf0-c04b-458c-9b68-16af9faaa9ea\",\n \"date\": \"2025-09-05T19:07:51.000Z\"\n },\n {\n \"notification_uuid\": \"1766ae9b-b06d-4486-8c41-37add23fe872\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_DELIVERING\",\n \"order_uuid\": \"b3372551-01d4-4de8-9f1b-d3e0c912992f\",\n \"order_id\": \"146390\",\n \"order_delivery_id\": \"119981\",\n \"hub_uuid\": \"dbe03cf0-c04b-458c-9b68-16af9faaa9ea\",\n \"date\": \"2025-09-05T19:08:03.000Z\"\n },\n {\n \"notification_uuid\": \"7d122bff-d184-4a19-bd62-b30e03fee07f\",\n \"type\": \"ORDER_DELIVERY_UPDATED\",\n \"subtype\": \"ORDER_DELIVERY_DELIVERED\",\n \"order_uuid\": \"b3372551-01d4-4de8-9f1b-d3e0c912992f\",\n \"order_id\": \"146390\",\n \"order_delivery_id\": \"119981\",\n \"hub_uuid\": \"dbe03cf0-c04b-458c-9b68-16af9faaa9ea\",\n \"date\": \"2025-09-05T19:08:11.000Z\"\n }\n]"}],"_postman_id":"9fa9913f-09aa-4955-8c2a-ae7c939e9ece"},{"name":"Enviar nota fiscal para o pedido","id":"8ae16820-541b-4c50-9e03-a24e8b88fb2c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"invoice_file","type":"file","value":null}]},"url":"https://api.hubii.co/hubs/:hub_uuid/orders/:order_uuid/invoice","description":"

Este endpoint permite o envio das informações de nota fiscal associadas a um pedido específico identificado pelo seu uuid. Após o envio bem-sucedido, o pedido será atualizado com os dados da nota fiscal.

\n
\n

Nota 1: O campo {hubUuid} na URL deve ser substituído pelo identificador único do Hub.
Nota 2: O campo {orderUuid} na URL deve ser substituído pelo identificador único do pedido.

\n
\n","urlObject":{"path":["hubs",":hub_uuid","orders",":order_uuid","invoice"],"host":["https://api.hubii.co"],"query":[],"variable":[{"type":"any","value":"","key":"hub_uuid"},{"type":"any","value":"","key":"order_uuid"}]}},"response":[{"id":"1b062fe6-4b4f-4faa-abaf-cec2779239b1","name":"[200] Enviar nota fiscal para o pedido","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"invoice_file","type":"file","value":null}]},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/invoice","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","invoice"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"22"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"8"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"8"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:37:39 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"1261"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"c3d55a45ab449b4958b37255173f7c63"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": true,\n \"message\": \"Invoice set successfully\"\n }\n}"},{"id":"df88c418-73cc-49de-b6fb-134c3a23211a","name":"[422] Enviar nota fiscal para o pedido","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"invoice_file","type":"file","value":null}]},"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid/invoice","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid","invoice"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"Unprocessable Content","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"21"},{"key":"RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"9"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"RateLimit-Remaining","value":"9"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:35:40 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"258"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"26954260301cc67ab1c5237a1a2f3d24"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"success\": false,\n \"error\": \"O Cep do comprador da nota fiscal precisa ser a mesma da venda. Cep Nota: 00000000 Cep Venda: 00000001\"\n }\n}"}],"_postman_id":"8ae16820-541b-4c50-9e03-a24e8b88fb2c"},{"name":"Reconhecimento de Notificação em Massa","id":"51a83e8a-f510-41d7-b4d0-23db9517db17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"uuids\": [\n \"9018e5d3-f653-443b-b64e-c45d475f0189\",\n \"4996dc47-1832-47da-82b9-04468e2696bf\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.hubii.co/notifications/ack","description":"

Este endpoint reconhece as notificações em massa para pedidos dos hubs que o usuário possui acesso. Utilize os uuids das notificações.

\n","urlObject":{"path":["notifications","ack"],"host":["https://api.hubii.co"],"query":[],"variable":[]}},"response":[],"_postman_id":"51a83e8a-f510-41d7-b4d0-23db9517db17"},{"name":"Detalhes do pedido","id":"fe61a343-28de-4e53-832d-b110b4ccf81d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.hubii.co/hubs/:hub_uuid/orders/:order_uuid","description":"

Este endpoint retorna os detalhes completos de um pedido específico identificado pelo seu uuid. As informações incluem valores totais, descontos, cliente, endereços de entrega e faturamento, e itens do pedido.

\n
\n

Nota 1: O campo {hubUuid} na URL deve ser substituído pelo identificador único do Hub.
Nota 2: O campo {orderUuid} na URL deve ser substituído pelo identificador único do pedido.
Nota 2: O campo invoice_allowed informa os tipos de notas fiscais que podem ser utilizadas para faturar o pedido:

\n
    \n
  • 55: Nota Fiscal Eletrônica (NF-e)
    • \n
  • 65: Nota Fiscal de Consumidor Eletrônica (NFC-e)
    • \n
\n
\n

Os status disponíveis do pedido são:

\n
    \n
  • waiting_group: Aguardando adensamento;
    • \n
  • searching_courier: Procurando motorista;
    • \n
  • courier_not_found: Nenhum motorista encontrado;
    • \n
  • courier_found: Motorista associado ao pedido;
    • \n
  • picking_up: Motorista indo para coleta;
    • \n
  • delivering: Pedido indo para o cliente;
    • \n
  • delivered: Entrega concluída com sucesso;
    • \n
  • canceled: Pedido cancelado;
    • \n
  • failed_to_delivery: Problema na entrega do pedido;
    • \n
  • lost: Pedido extraviado.
    • \n
\n","urlObject":{"path":["hubs",":hub_uuid","orders",":order_uuid"],"host":["https://api.hubii.co"],"query":[],"variable":[{"type":"any","value":"","key":"hub_uuid"},{"type":"any","value":"","key":"order_uuid"}]}},"response":[{"id":"3b2dbb8b-3bd2-45d0-8d64-1f2bd3b51b4f","name":"[200] Detalhes do pedido","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.hubii.co/hubs/:hubUuid/orders/:orderUuid","host":["https://api.hubii.co"],"path":["hubs",":hubUuid","orders",":orderUuid"],"variable":[{"key":"hubUuid","value":"b6f2eefa-da34-4daa-ae2b-98c3bd7b29c2"},{"key":"orderUuid","value":"71402839-ecb5-4ee0-b73a-331e7bef74f5"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"57"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"9"},{"key":"RateLimit-Limit","value":"10"},{"key":"RateLimit-Remaining","value":"9"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:23:03 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"435"},{"key":"X-Kong-Proxy-Latency","value":"28"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"0fc2e13cae12bc7d80a3db053b5f4826"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": 102656,\n \"uuid\": \"71402839-ecb5-4ee0-b73a-331e7bef74f5\",\n \"subtotal\": 53.79,\n \"discount\": 3.24,\n \"delivery_cost\": 0,\n \"total\": 50.55,\n \"transfer_total\": 50.79,\n \"status\": \"picking_up\",\n \"invoice_allowed\": [\n 55,\n 65\n ],\n \"customer\": {\n \"name\": \"Nome do Cliente\",\n \"document\": \"00000000000\"\n },\n \"delivery_address\": {\n \"street_name\": \"Rua do Cliente\",\n \"address_number\": \"000\",\n \"complement\": null,\n \"postal_code\": \"00000000\",\n \"neighborhood_name\": \"Bairro\",\n \"city_name\": \"Cidade\",\n \"province_code\": \"UF\",\n \"country_code\": \"BR\"\n },\n \"invoice_address\": {\n \"street_name\": \"Rua do Cliente\",\n \"address_number\": \"000\",\n \"complement\": null,\n \"postal_code\": \"00000000\",\n \"neighborhood_name\": \"Bairro\",\n \"city_name\": \"Cidade\",\n \"province_code\": \"UF\",\n \"country_code\": \"BR\"\n },\n \"items\": [\n {\n \"uuid\": \"a933aab6-c880-470b-b3be-2cc5af040263\",\n \"quantity\": 2,\n \"unit_price\": 21.33,\n \"total\": 42.66,\n \"transfer_total\": 40.66,\n \"ean\": \"7896029052334\",\n \"product\": \"Petisco Pedigree Dentastix Cuidado Oral Para Cães Adultos Raças Pequenas 7 Unidades\"\n },\n {\n \"uuid\": \"53477ee8-65e2-458a-a3dc-63fbd63285bf\",\n \"quantity\": 3,\n \"unit_price\": 3.71,\n \"total\": 11.13,\n \"transfer_total\": 10.13,\n \"ean\": \"7896029022276\",\n \"product\": \"Ração Úmida Pedigree Sachê Cordeiro ao Molho para Cães Adultos de Raças Pequenas 100 g 1un\"\n }\n ]\n }\n}"}],"_postman_id":"fe61a343-28de-4e53-832d-b110b4ccf81d"},{"name":"Download etiqueta de despacho de pedido","id":"47887fd3-96aa-48f3-b71a-8dad14fe00cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.hubii.co/hubs/:hub_uuid/orders/:order_uuid/label","description":"

Este endpoint faz download da etiqueta de despacho

\n","urlObject":{"path":["hubs",":hub_uuid","orders",":order_uuid","label"],"host":["https://api.hubii.co"],"query":[],"variable":[{"type":"any","value":"","key":"hub_uuid"},{"type":"any","value":"","key":"order_uuid"}]}},"response":[{"id":"bb8aa77c-f8a6-476b-ac8d-5066c88f4e85","name":"Download etiqueta de despacho de pedido","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.hubii.co/hubs/:hub_uuid/orders/:order_uuid/label","host":["https://api.hubii.co"],"path":["hubs",":hub_uuid","orders",":order_uuid","label"],"variable":[{"key":"hub_uuid","value":"c6a276b6-ad59-498f-83b6-ee12234a513f"},{"key":"order_uuid","value":"f8aabd66-ee42-4e9e-9415-1ff0935610d7"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":":status","value":200},{"key":"date","value":"Tue, 17 Mar 2026 18:41:32 GMT"},{"key":"content-type","value":"application/json"},{"key":"x-ratelimit-remaining-minute","value":"299"},{"key":"x-ratelimit-limit-minute","value":"300"},{"key":"ratelimit-remaining","value":"299"},{"key":"ratelimit-reset","value":"29"},{"key":"ratelimit-limit","value":"300"},{"key":"server","value":"cloudflare"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"PHP/8.2.29"},{"key":"cache-control","value":"no-cache, private"},{"key":"x-ratelimit-limit","value":"60"},{"key":"x-ratelimit-remaining","value":"59"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"content-encoding","value":"gzip"},{"key":"x-kong-upstream-latency","value":"1034"},{"key":"x-kong-proxy-latency","value":"3"},{"key":"via","value":"1.1 kong/3.9.1"},{"key":"x-kong-request-id","value":"ac03a46cadc78b492b0a6e6824cf4256"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"report-to","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=T70xSrp7pP4Y7w%2FH0wTkIVjUNoRYDx3zQsZ1sVXmlPU2%2BcNS6tidu5whD%2FcFLUvGw3fvFewho9POIzCSBHWivuhuDk5xUwO%2FSX6b5fvuluHGnxgSpyNEe0P72UUKqc4%3D\"}]}"},{"key":"cf-ray","value":"9dde21dbfd0ae6c8-GIG"}],"cookie":[],"responseTime":null,"body":"{\n \"url\": \"https://etiquetas-hubii.s3.amazonaws.com/precode-2782-124459.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA2VVGSYJZWN7WB2WE%2F20260317%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260317T184132Z&X-Amz-SignedHeaders=host&X-Amz-Expires=300&X-Amz-Signature=48207b9e9f62cfdb204a270da83983681335065e4b45a38239d84dcc3283c021\"\n}"}],"_postman_id":"47887fd3-96aa-48f3-b71a-8dad14fe00cd"},{"name":"Listagem de Hubs","id":"1bdbc3e2-b1f0-473a-94a6-9feae3bf8aa4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.hubii.co/hubs","description":"

Este endpoint retorna uma lista paginada de Hubs aos quais o usuário autenticado tem permissão de acesso. Cada Hub contém informações detalhadas, incluindo nome, razão social, documento e endereço completo.

\n
\n

Nota: O campo uuid é usado como identificador único do Hub e deve ser utilizado como referência em requisições subsequentes relacionadas ao Hub.

\n
\n","urlObject":{"path":["hubs"],"host":["https://api.hubii.co"],"query":[],"variable":[]}},"response":[{"id":"3d3ee97d-c15b-45ea-9274-b1b3a94577e6","name":"[200] Listagem de Hubs","originalRequest":{"method":"GET","header":[],"url":"https://api.hubii.co/hubs"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"RateLimit-Reset","value":"58"},{"key":"X-RateLimit-Limit-Minute","value":"10"},{"key":"X-RateLimit-Remaining-Minute","value":"9"},{"key":"RateLimit-Limit","value":"10"},{"key":"RateLimit-Remaining","value":"9"},{"key":"Host","value":"hub-service"},{"key":"X-Powered-By","value":"PHP/8.1.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 21 Nov 2024 14:00:02 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Server","value":"kong/3.8.0"},{"key":"X-Kong-Upstream-Latency","value":"530"},{"key":"X-Kong-Proxy-Latency","value":"3"},{"key":"Via","value":"1.1 kong/3.8.0"},{"key":"X-Kong-Request-Id","value":"fb00546bf610dd0d360cc12a3cbd5545"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"uuid\": \"fabb88b2-0954-43db-b32a-e482d5406183\",\n \"name\": \"Nome do Seu Hub\",\n \"trading_name\": \"Seu Hub LTDA\",\n \"document\": \"00000000000100\",\n \"address\": {\n \"street_name\": \"Rua do Seu Hub\",\n \"address_number\": \"000\",\n \"complement\": \"loja 1 e 2\",\n \"postal_code\": \"00000-000\",\n \"neighborhood_name\": \"bairro\",\n \"city_name\": \"cidade\",\n \"province_code\": \"UF\",\n \"country_code\": \"BR\"\n }\n }\n ],\n \"links\": {\n \"first\": \"http://hub-service/api/hubs?search=&order_by=name&order_direction=asc&per_page=10&load=address&page=1\",\n \"last\": \"http://hub-service/api/hubs?search=&order_by=name&order_direction=asc&per_page=10&load=address&page=1\",\n \"prev\": null,\n \"next\": null\n },\n \"meta\": {\n \"current_page\": 1,\n \"from\": 1,\n \"last_page\": 1,\n \"links\": [\n {\n \"url\": null,\n \"label\": \"« Previous\",\n \"active\": false\n },\n {\n \"url\": \"http://hub-service/api/hubs?search=&order_by=name&order_direction=asc&per_page=10&load=address&page=1\",\n \"label\": \"1\",\n \"active\": true\n },\n {\n \"url\": null,\n \"label\": \"Next »\",\n \"active\": false\n }\n ],\n \"path\": \"http://hub-service/api/hubs\",\n \"per_page\": 10,\n \"to\": 6,\n \"total\": 6\n }\n}"}],"_postman_id":"1bdbc3e2-b1f0-473a-94a6-9feae3bf8aa4"},{"name":"Cancelamento do Pedido","id":"14c91225-96d3-44d0-8e9e-48f14e41d5f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.hubii.co/hubs/:hub_uuid/orders/:order_uuid/cancel-accepted","description":"

Este endpoint possibilita o varejista/hub à cancelar um pedido mesmo depois de aceito. O pedido será redirecionado para outro parceiro Hubii e não cancelado para o cliente.

\n","urlObject":{"path":["hubs",":hub_uuid","orders",":order_uuid","cancel-accepted"],"host":["https://api.hubii.co"],"query":[],"variable":[{"description":{"content":"

UUID único do Hub

\n","type":"text/plain"},"type":"any","value":"","key":"hub_uuid"},{"description":{"content":"

UUID único do Pedido

\n","type":"text/plain"},"type":"any","value":"","key":"order_uuid"}]}},"response":[],"_postman_id":"14c91225-96d3-44d0-8e9e-48f14e41d5f2"},{"name":"[Descontinuado] Pedidos esperando faturamento","id":"d3fd9e99-ba9a-4e84-ba80-009302a08eaa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://api.hubii.co/hubs/:hub_uuid/orders/to-invoice?blocks_shipping=&date_from&accepted_from","urlObject":{"path":["hubs",":hub_uuid","orders","to-invoice"],"host":["https://api.hubii.co"],"query":[{"description":{"content":"

Filtra os pedidos que precisam de nota fiscal obrigatoriamente para expedição do pedido

\n","type":"text/plain"},"key":"blocks_shipping","value":""},{"description":{"content":"

Filtra os pedidos pelo datetime que o cliente realizou a compra. Ex: 2026-03-20 09:00:00-03:00

\n","type":"text/plain"},"key":"date_from","value":null},{"description":{"content":"

Filtra os pedidos pela datetime que o hub aceitou. Ex: 2026-03-20 09:00:00-03:00

\n","type":"text/plain"},"key":"accepted_from","value":null}],"variable":[{"description":{"content":"

UUID único do Hub

\n","type":"text/plain"},"type":"any","value":"","key":"hub_uuid"}]}},"response":[{"id":"08706fb7-946f-4b71-9520-c50a509a4474","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://api.hubii.co/hubs/:hub_uuid/orders/to-invoice","host":["https://api.hubii.co"],"path":["hubs",":hub_uuid","orders","to-invoice"],"variable":[{"key":"hub_uuid","value":"","description":"UUID único do Hub"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Fri, 20 Mar 2026 12:57:23 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"ratelimit-remaining","value":"598"},{"key":"ratelimit-reset","value":"37"},{"key":"ratelimit-limit","value":"600"},{"key":"x-ratelimit-remaining-minute","value":"598"},{"key":"x-ratelimit-limit-minute","value":"600"},{"key":"Server","value":"cloudflare"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"PHP/8.2.29"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"x-ratelimit-limit","value":"60"},{"key":"x-ratelimit-remaining","value":"58"},{"key":"access-control-allow-origin","value":"*"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"x-content-type-options","value":"nosniff"},{"key":"Content-Encoding","value":"gzip"},{"key":"x-kong-upstream-latency","value":"337"},{"key":"x-kong-proxy-latency","value":"2"},{"key":"via","value":"1.1 kong/3.9.1"},{"key":"x-kong-request-id","value":"0ad8ae2c72e6dc7e478804580623f662"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=w3hBXflqPpn%2BzSyjQDftkxMhfmihQZN5A%2F7qTG5kTI%2FiuzwFGwVU3lHUy38ZJx%2Fnd8Kq8Tm6fTtZxKYbJxGZM5r0S95NOyT5bv4p9VE3X01dN3PzmA%3D%3D\"}]}"},{"key":"CF-RAY","value":"9df4e1e04b7581d6-GRU"}],"cookie":[],"responseTime":null,"body":"{\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": 620969,\n \"uuid\": \"c8bd105e-9f01-47e8-98e9-6f26cd463dc3\",\n \"total\": 76.64\n }\n ],\n \"next_page_url\": \"http://order-service/hubs/orders/to-invoice?per_page=20&page=2\",\n \"path\": \"http://order-service/hubs/orders/to-invoice\",\n \"per_page\": 20,\n \"prev_page_url\": null,\n \"to\": 20,\n \"total\": 1\n}"}],"_postman_id":"d3fd9e99-ba9a-4e84-ba80-009302a08eaa"}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apikey"},{"key":"value","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"9917331a-e347-4c6e-a8fa-be736c5ba65d","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"4ec6759b-d0a8-4d26-ab43-c436426f0bc1","type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"base_url","value":"https://api.hubii.co"},{"key":"apikey","value":"sua_apikey"},{"key":"hub_uuid","value":"b37e6cdc-f002-48bb-93a2-29d9240d6f9c"},{"key":"order_uuid","value":"fabb88b2-0954-43db-b32a-e482d5406183"}]}