Skip to content
Auth
/
Gerar token de autenticação

Integrador Pigz (1.1.0)

O que é o Integrador Pigz

A API do Integrador Pigz permite que sistemas terceiros (como PDVs ou plataformas de pedidos) recebam e manipulem pedidos da Pigz.

Ela foi projetada para integrar pedidos da Pigz em sistemas de Ponto de Venda (PDV) ou plataformas de captação de pedidos online. Através dela é possível consultar pedidos novos ou cancelados e atualizar o status de cada pedido conforme o fluxo de operação da loja.

Exemplo de fluxo

  1. Um cliente realiza um pedido na Pigz.
  2. O sistema PDV parceiro consulta periodicamente os pedidos via Pooling.
  3. Assim que o pedido chega ao PDV, ele deve confirmar o recebimento via Change Stage Order (stage = conhecido ou integrado).
  4. O PDV atualiza os status seguintes até o pedido ser entregue, retirado ou cancelado.

Essa comunicação garante sincronização entre a Pigz e os sistemas parceiros.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
E-mail

dev@pigz.com.br

License

MIT

Languages
Servers
Mock server

https://docs.pigz.dev/_mock/openapi/

https://integrador.pigz.dev/

https://integrador.pigz.com.br/

Auth

Autenticação e geração de token

Operations

Gerar token de autenticação

Request

Gera um token JWT válido por 12 horas.
É necessário enviar credenciais via Basic Auth (email:senha em Base64).

Security
basicAuth
curl -i -X POST \
  -u <username>:<password> \
  https://docs.pigz.dev/_mock/openapi/authentication

Responses

Token gerado com sucesso

Bodyapplication/json
tokenstring

Token JWT

Example: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1..."
expirenumber

Timestamp de expiração em segundos

Example: 959804400
Response
application/json
{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1...",
  "expire": 959804400
}

Orders

Consulta e atualização de pedidos

Operations

Merchant

Gerenciamento de abertura/fechamento de lojas

Operations