POST /v3/comandos/iniciou

Notifica a Maggu que o processamento de um comando foi iniciado e informa o total de registros que serão enviados. Deve ser chamado antes de enviar os lotes.

Requisição

POST /v3/comandos/{id}/iniciou

{
  "totalDeRegistrosAEnviar": 1500
}

Campo	Tipo	Obrigatório	Descrição
id	number	Sim	ID do comando em execução
totalDeRegistrosAEnviar	number	Não	Quantidade total de registros que serão enviados (recomendado — permite diagnóstico de progresso)

Implementação .NET

var requisicao = new RestRequest("api/v3/comandos/iniciou", Method.Post);
requisicao.AddJsonBody(new { id = Id, total = registros.Count }); // total opcional, mas recomendado
await _provedor.Client.PostAsync(requisicao, ct);

foreach (var lote in registros.Chunk(400))
{
    // envia os lotes normalmente
}

Respostas

Código	Significado
200 OK	Notificação registrada
400 Bad Request	Corpo inválido
403 Forbidden	Token inválido
404 Not Found	Comando não encontrado