ENVIAR_TODOS_PRODUTOS

Envia todo o catálogo de produtos da loja para a Maggu. Usado na sincronização inicial ou quando uma re-sincronização completa é necessária.

Argumentos: nenhum

Comando tipo: sem argumentos

Payload recebido

{
  "id": 5003,
  "tipo": "ENVIAR_TODOS_PRODUTOS",
  "argumentos": {},
  "criadoEm": "2026-05-13T10:10:00Z"
}

Implementação

def enviar_todos_produtos(cmd):
    produtos = erp.buscar_todos_produtos()

    session.post("api/v3/comandos/iniciou", json={"id": cmd["id"], "total": len(produtos)})

    for lote in chunk(produtos, 400):
        session.post("api/v3/produtos/registrar-em-lote", json={"comandoId": cmd["id"], "conteudo": lote})

Chamada à API Maggu

POST /v3/produtos/registrar-em-lote

{
  "comandoId": 5003,
  "conteudo": [
    {
      "ean": "7891000315507",
      "nome": "Paracetamol 750mg 20 comprimidos",
      "precoVenda": "9.50",
      "precoVendaDesconto": "8.00",
      "estoqueUnidades": 120
    }
  ]
}

Campo	Tipo	Obrigatório	Descrição
ean	string	Sim	Código EAN do produto — chave de idempotência
nome	string	Sim	Nome do produto
precoVenda	decimal	Sim	Preço unitário sem desconto
precoVendaDesconto	decimal	Sim	Preço unitário com desconto
estoqueUnidades	integer	Não	Quantidade em estoque

Respostas:

Código	Significado
202 Accepted	Lote em processamento
400 Bad Request	Erro de validação
403 Forbidden	Token inválido