ENVIAR_DEVOLUCOES_INTERVALO

Envia todas as devoluções realizadas no período para a Maggu. Mantém o histórico de trocas e estornos sincronizado.

Argumentos: de, ate (datetime ISO 8601 UTC)

Comando tipo: com intervalo de datas

Payload recebido

{
  "id": 5007,
  "tipo": "ENVIAR_DEVOLUCOES_INTERVALO",
  "argumentos": {
    "de": "2026-05-01T00:00:00Z",
    "ate":    "2026-05-13T23:59:59Z"
  },
  "criadoEm": "2026-05-13T10:30:00Z"
}

Implementação

def enviar_devolucoes_intervalo(cmd):
    devolucoes = erp.buscar_devolucoes(cmd["argumentos"]["de"], cmd["argumentos"]["ate"])

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

Chamada à API Maggu

POST /v3/devolucoes/registrar-em-lote

{
  "comandoId": 5007,
  "conteudo": [
    {
      "codigoExterno": "DEV-2026-00001",
      "realizadaEm": "2026-05-10T16:00:00Z",
      "codigoExternoDaVendaOrigem": "VND-2026-00123",
      "codigoExternoDoUsuario": "USR-001",
      "cpfCnpjDoCliente": "123.456.789-00",
      "itens": [
        {
          "ean": "7891000315507",
          "quantidade": 1,
          "precoVenda": "8.90",
          "precoVendaDesconto": "7.50",
          "custoCompra": "4.20"
        }
      ]
    }
  ]
}

Campo	Tipo	Obrigatório	Descrição
codigoExterno	string	Sim	Chave única da devolução no ERP
realizadaEm	datetime	Sim	Momento da devolução
codigoExternoDaVendaOrigem	string	Não	Venda que originou a devolução
codigoExternoDoUsuario	string	Não	Usuário que processou a devolução
cpfCnpjDoCliente	string	Não	Cliente que devolveu
itens[].ean	string	Sim	EAN do produto devolvido
itens[].quantidade	integer	Sim	Quantidade devolvida
itens[].precoVenda	decimal	Sim	Preço unitário original
itens[].precoVendaDesconto	decimal	Sim	Preço com desconto original
itens[].custoCompra	decimal	Sim	Custo unitário

Respostas:

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