Skip to content
Last updated

Bem-vindo à documentação do Integrador Pigz, a API que permite que sistemas terceiros (como PDVs ou plataformas de pedidos) recebam e manipulem pedidos da Pigz.

O Integrador Pigz foi projetado para facilitar a integração de pedidos, permitindo consultar novos pedidos ou cancelamentos, atualizar o status de pedidos e gerenciar o estado das lojas.


Começando

O Integrador Pigz possui endpoints para autenticação, consulta de pedidos, alteração de estágio de pedidos e abertura/fechamento de lojas.

Você precisará de um token de autenticação (JWT) para acessar a maioria dos endpoints. Este token é gerado via Basic Auth com email e senha de uma loja cadastrada na Pigz.


Estrutura de arquivos

index.md

Esta página é a landing page da documentação do Integrador Pigz.
Você pode adicionar descrições, instruções de uso e links úteis aqui. Suporta Markdown e tags Markdoc.

openapi.yaml

O arquivo openapi.yaml contém a descrição completa da API do Integrador Pigz em formato OpenAPI 2.0 (Swagger).
Ele inclui:

  • Autenticação (/authentication)
  • Consulta de pedidos (/pooling)
  • Alteração de estágio de pedidos (/pedido/{id}/{stage})
  • Abertura/fechamento de loja (/merchant/{openOrClose})

Você pode baixar o arquivo e utilizá-lo em ferramentas como Swagger UI, Postman ou Redocly para testar a API ou gerar SDKs.


Como usar

  1. Gere seu token enviando suas credenciais via /authentication.
  2. Use o Bearer Token para consultar pedidos com /pooling.
  3. Atualize o status dos pedidos usando /pedido/{id}/{stage}.
  4. Abra ou feche lojas com /merchant/{openOrClose} conforme necessário.

⚠️ Atenção: Para que os pedidos não sejam enviados novamente, sempre marque o pedido como conhecido ou integrado após recebê-lo.


Recursos úteis


Suporte

Para dúvidas sobre integração, entre em contato com o suporte da Pigz.