ENVIAR_CONTRAPROVA_VENDAS_INTERVALO

Envia totalizadores diários de vendas para que a Maggu reconcilie os dados recebidos via ENVIAR_VENDAS_INTERVALO. Se o total enviado difere do calculado pela Maggu, a equipe é alertada sobre inconsistências.

Argumentos: de, ate (datetime ISO 8601 UTC)

Comando tipo: com intervalo de datas

Payload recebido

{
  "id": 5009,
  "tipo": "ENVIAR_CONTRAPROVA_VENDAS_INTERVALO",
  "argumentos": {
    "de": "2026-05-13T00:00:00Z",
    "ate":    "2026-05-13T23:59:59Z"
  },
  "criadoEm": "2026-05-13T10:40:00Z"
}

Implementação

from datetime import datetime, timedelta

def enviar_contraprova_vendas(cmd):
    de  = datetime.fromisoformat(cmd["argumentos"]["de"].replace("Z", "+00:00")).date()
    ate = datetime.fromisoformat(cmd["argumentos"]["ate"].replace("Z", "+00:00")).date()

    dia = de
    while dia <= ate:
        totais = erp.calcular_totais_vendas(dia)
        session.post("api/v3/vendas/contraprovas", json={
            "dia":                    dia.isoformat(),
            "numeroDeVendas":         totais["numero_de_vendas"],
            "unidadesVendidas":       totais["unidades_vendidas"],
            "valorTotalSemDesconto":  f"{totais['valor_sem_desconto']:.2f}",
            "valorTotalComDesconto":  f"{totais['valor_com_desconto']:.2f}",
        })
        dia += timedelta(days=1)

Chamada à API Maggu

POST /v3/vendas/contraprovas

{
  "dia": "2026-05-13",
  "numeroDeVendas": 87,
  "unidadesVendidas": 312,
  "valorTotalSemDesconto": "4250.00",
  "valorTotalComDesconto": "3980.50"
}

Campo	Tipo	Obrigatório	Descrição
dia	date	Sim	Data das vendas (YYYY-MM-DD)
numeroDeVendas	integer	Sim	Total de vendas realizadas no dia
unidadesVendidas	integer	Sim	Total de unidades vendidas
valorTotalSemDesconto	decimal	Sim	Valor bruto total
valorTotalComDesconto	decimal	Sim	Valor líquido total

Respostas:

Código	Significado
204 No Content	Contra-prova registrada
400 Bad Request	Erro de validação
403 Forbidden	Token inválido

Um payload por dia

Envie um payload separado para cada dia do intervalo. A Maggu acumula os totalizadores por data e os compara com os registros de venda individuais recebidos anteriormente.