ENVIAR_CONTRAPROVA_DEVOLUCOES_INTERVALO

Envia totalizadores diários de devoluções para reconciliação. Funciona da mesma forma que a contra-prova de vendas, mas para o fluxo de estornos.

Argumentos: de, ate (datetime ISO 8601 UTC)

Herda de ComandoComIntervaloDeDatas

Payload recebido

{
  "id": 5010,
  "tipo": "ENVIAR_CONTRAPROVA_DEVOLUCOES_INTERVALO",
  "argumentos": {
    "de": "2026-05-13T00:00:00Z",
    "ate":    "2026-05-13T23:59:59Z"
  },
  "criadoEm": "2026-05-13T10:45:00Z"
}

Implementação .NET

public class EnviarContraprovaDevolucoesIntervaloComando : ComandoComIntervaloDeDatas
{
    protected override async Task ExecutarAsync(CancellationToken ct)
    {
        for (var dia = Argumentos.De.Date;
             dia <= Argumentos.Ate.Date;
             dia = dia.AddDays(1))
        {
            var totais = await _erp.CalcularTotaisDevolucoesAsync(dia, ct);

            var requisicao = new RestRequest("api/v3/devolucoes/contraprovas", Method.Post);
            requisicao.AddJsonBody(new
            {
                dia                      = dia.ToString("yyyy-MM-dd"),
                numeroDeDevolucoes     = totais.NumeroDeDevolucoes,
                unidadesDevolvidas      = totais.UnidadesDevolvidas,
                valorTotalSemDesconto = totais.ValorSemDesconto.ToString("F2"),
                valorTotalComDesconto = totais.ValorComDesconto.ToString("F2"),
            });
            await _provedor.Client.PostAsync(requisicao, ct);
        }
    }
}

Chamada à API Maggu

POST /v3/devolucoes/contraprovas

{
  "dia": "2026-05-13",
  "numeroDeDevolucoes": 3,
  "unidadesDevolvidas": 5,
  "valorTotalSemDesconto": "44.50",
  "valorTotalComDesconto": "37.50"
}

Campo	Tipo	Obrigatório	Descrição
dia	date	Sim	Data das devoluções (YYYY-MM-DD)
numeroDeDevolucoes	integer	Sim	Quantidade de devoluções no dia
unidadesDevolvidas	integer	Sim	Total de unidades devolvidas
valorTotalSemDesconto	decimal	Sim	Valor bruto devolvido
valorTotalComDesconto	decimal	Sim	Valor líquido devolvido

Respostas:

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