Integração

API do PedidoFácil Encartes

Se o seu sistema já tem os produtos e os preços, ele manda a lista para cá por HTTP e recebe de volta a etiqueta, o encarte ou o cardápio prontos, com um link de impressão. Ninguém digita nada duas vezes.

1. Token de integração

Toda chamada precisa de um token. Você cria em Integrações, dentro da sua conta, escolhendo quais módulos ele pode usar. O token aparece uma única vez: guardamos apenas um resumo criptográfico dele, então não há como recuperá-lo depois — se perder, revogue e crie outro.

Mande-o no cabeçalho Authorization de toda requisição:

Authorization: Bearer pfk_0123456789abcdef...

Para conferir se está funcionando:

curl -H "Authorization: Bearer SEU_TOKEN" \
     https://encarte.pedidofacil.cloud/api/v1/conta

2. Criar um lote de etiquetas

É o caminho mais usado: você manda os produtos e recebe o lote criado, já com o link de impressão que pode ser aberto direto pelo seu sistema, sem login.

POST https://encarte.pedidofacil.cloud/api/v1/etiquetas
Authorization: Bearer SEU_TOKEN
Content-Type: application/json

{
  "titulo": "Ofertas da semana",
  "tamanho": "media",
  "estilo": "oferta",
  "termica": true,
  "itens": [
    { "nome": "Arroz Tio João 5kg", "preco": "24,90", "preco_de": "29,90", "qtd": 2 },
    { "nome": "Feijão Carioca 1kg", "preco": "7,49", "unidade": "kg" },
    {
      "nome": "Creme Gelado 1L",
      "preco": "7,00",
      "codigo": "7891000315507",
      "fabricacao": "30/09/2026",
      "validade": "30/10/2026",
      "opcoes_titulo": "Sabor",
      "opcoes": ["Morango", "Uva", "Limão"],
      "textos": ["Conservar refrigerado"]
    }
  ]
}

Resposta (201 Created):

{
  "dados": {
    "id": 128,
    "titulo": "Ofertas da semana",
    "tamanho": "media",
    "url_impressao": "https://encarte.pedidofacil.cloud/i/5f1c...",
    "url_editor": "https://encarte.pedidofacil.cloud/etiquetas/128/editar",
    "total_etiquetas": 4,
    "por_pagina": 12,
    "documento": { ... }
  }
}

3. Campos de cada item

Campos fora dessa lista são ignorados, e valores fora do permitido são cortados para o limite — a API nunca grava um documento que a tela não saiba desenhar.

4. Endpoints

4.1. Encarte e cardápio

Seguem o mesmo padrão das etiquetas; muda só o nome da lista.

POST https://encarte.pedidofacil.cloud/api/v1/encartes
{
  "titulo": "Ofertas da semana",
  "formato": "A4",
  "tema": "supermercado",
  "publicar": true,
  "produtos": [
    { "nome": "Arroz 5kg", "preco": "24,90", "preco_de": "29,90", "emoji": "\ud83c\udf5a" },
    { "nome": "Feijão 1kg", "preco": "7,49" }
  ]
}

POST https://encarte.pedidofacil.cloud/api/v1/cardapios
{
  "titulo": "Cardápio da casa",
  "publicar": true,
  "secoes": [
    {
      "nome": "Lanches",
      "itens": [ { "nome": "X-Burger", "descricao": "Pão, carne e queijo", "preco": "22,00" } ]
    }
  ]
}

Com "publicar": true, a resposta traz url_publica — o endereço que você pode mandar no WhatsApp ou colocar num QR Code. Sem isso, o campo volta null e a arte fica só na conta.

5. Erros

Todo erro vem no mesmo formato, com um código estável — trate pelo código, não pelo texto:

{ "erro": { "codigo": "sem_escopo", "mensagem": "Este token não tem permissão para o módulo \"etiquetas\"." } }

6. Limites e segurança

• 300 chamadas por minuto por token e 600 por endereço de IP.
• O token pode ser marcado como somente leitura e pode ser preso a uma lista de IPs.
• Cada token vê apenas os dados da conta dele — não há como alcançar outra conta.
• Toda chamada fica registrada com horário, IP, rota, resposta e tempo, e aparece em Integrações.
• O token é guardado como resumo criptográfico (SHA-256); quem tiver acesso ao banco não consegue usá-lo.
• A revogação vale na hora, sem esperar cache.

7. Exemplo em PHP

$ch = curl_init('https://encarte.pedidofacil.cloud/api/v1/etiquetas');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $token,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'titulo' => 'Ofertas de hoje',
        'termica' => true,
        'itens' => $produtos, // [['nome' => ..., 'preco' => ...], ...]
    ], JSON_UNESCAPED_UNICODE),
]);
$resposta = json_decode(curl_exec($ch), true);
$linkImpressao = $resposta['dados']['url_impressao'];