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)

Herda de ComandoComIntervaloDeDatas

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 .NET

public class EnviarContraprovaVendasIntervaloComando : ComandoComIntervaloDeDatas
{
    protected override async Task ExecutarAsync(CancellationToken ct)
    {
        // Iterar dia a dia dentro do intervalo
        for (var dia = Argumentos.De.Date;
             dia <= Argumentos.Ate.Date;
             dia = dia.AddDays(1))
        {
            var totais = await _erp.CalcularTotaisVendasAsync(dia, ct);

            var requisicao = new RestRequest("api/v3/vendas/contraprovas", Method.Post);
            requisicao.AddJsonBody(new
            {
                dia                     = dia.ToString("yyyy-MM-dd"),
                numeroDeVendas        = totais.NumeroDeVendas,
                unidadesVendidas       = totais.UnidadesVendidas,
                valorTotalSemDesconto = totais.ValorSemDesconto.ToString("F2"),
                valorTotalComDesconto = totais.ValorComDesconto.ToString("F2"),
            });
            await _provedor.Client.PostAsync(requisicao, ct);
        }
    }
}

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.