ENVIAR_COMPRAS_INTERVALO

Envia as notas de entrada (compras de fornecedores) do período para a Maggu. Permite rastrear o custo de aquisição dos produtos ao longo do tempo.

Argumentos: de, ate (datetime ISO 8601 UTC)

Comando tipo: com intervalo de datas

Payload recebido

{
  "id": 5008,
  "tipo": "ENVIAR_COMPRAS_INTERVALO",
  "argumentos": {
    "de": "2026-05-01T00:00:00Z",
    "ate":    "2026-05-13T23:59:59Z"
  },
  "criadoEm": "2026-05-13T10:35:00Z"
}

Implementação

def enviar_compras_intervalo(cmd):
    compras = erp.buscar_notas_entrada(cmd["argumentos"]["de"], cmd["argumentos"]["ate"])

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

Chamada à API Maggu

POST /v3/compras/registrar-em-lote

{
  "comandoId": 5008,
  "conteudo": [
    {
      "chaveDeAcesso": "35260512345678000195550010000001231234567890",
      "codigoExterno": "NF-2026-0042",
      "cpfCnpjRemetente": "12345678000195",
      "cpfCnpjDestinatario": "11444777000161",
      "dataDeEmissao": "2026-05-10T08:00:00Z",
      "valorTotalBruto": "1250.00",
      "valorTotalLiquido": "1187.50",
      "itens": [
        {
          "ean": "7891000315507",
          "quantidade": 100,
          "valorTotal": "420.00"
        }
      ]
    }
  ]
}

Campo	Tipo	Obrigatório	Descrição
chaveDeAcesso	string	Sim	Chave da NF-e (44 dígitos)
codigoExterno	string	Sim	Código interno da nota no ERP
cpfCnpjRemetente	string	Sim	CNPJ do fornecedor
cpfCnpjDestinatario	string	Sim	CNPJ da loja
dataDeEmissao	datetime	Sim	Data de emissão da nota
valorTotalBruto	decimal	Sim	Valor bruto da nota
valorTotalLiquido	decimal	Sim	Valor líquido (após descontos/impostos)
itens[].ean	string	Sim	EAN do produto comprado
itens[].quantidade	integer	Sim	Quantidade (mínimo 1)
itens[].valorTotal	decimal	Sim	Valor total do item na nota

Respostas:

Código	Significado
204 No Content	Compras registradas com sucesso
400 Bad Request	Erro de validação
403 Forbidden	Token inválido