Skip to content

Pigz Integrator (1.1.0)

What is the Pigz Integrator

The Pigz Integrator API allows third-party systems (such as POS systems or order platforms) to receive and manage orders from Pigz.

It is designed to integrate Pigz orders into Point of Sale (POS) systems or online ordering platforms.
Through this API, you can query new or canceled orders and update each order’s status according to the store’s operational flow.

Example Workflow

  1. A customer places an order on Pigz.
  2. The partner POS system periodically fetches orders via the Pooling endpoint.
  3. Once the order reaches the POS, it should confirm receipt using the Change Stage Order endpoint (stage = known or integrated).
  4. The POS then updates the order status through its lifecycle until it is delivered, picked up, or canceled.

This communication ensures synchronization between Pigz and partner systems.

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

Authentication and token generation

Operations

Generate authentication token

Request

Generates a valid JWT token (expires in 12 hours).
Credentials must be sent via Basic Auth (email:password encoded in Base64).

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

Responses

Token successfully generated

Bodyapplication/json
tokenstring

JWT token

Example: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1..."
expirenumber

Expiration timestamp (in seconds)

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

Orders

Order retrieval and status updates

Operations

Merchant

Store open/close management

Operations