Limites
Possuímos um limite de 1 request por segundo e os recursos de importação de venda devem contemplar até 10000 objetos, pois todas as vendas são validadas antes de serem importadas impactando a perfomance para o retorno. Caso seja identificado um volume alto de requisições para cada venda, você receberá um erro 429 too many request. As consultas podem ser feitas a qualquer horário do dia e o serviço fica disponível 24 horas.
Envio de vendas
Ao enviar uma request, somente após o retorno "201 OK" o próximo lote com até 10000
objetos para importação deve ser enviado, assim evitamos respostas inesperadas como 503/429.
Rotinas de consultas para baixa.
Os resultados dos processos de conciliação são disponibilizados no dia seguinte, sendo assim se seu processo seguiu o fluxo de conciliação conforme a imagem abaixo, os resultados estarão disponíveis com a identificação da sua chave para baixa no dia seguinte.
Para conciliações pontuais ou retroativas você pode seguir o mesmo exemplo acima e no dia seguinte, pode consultar se os resultados dos lançamentos foram conciliados ou não através dos serviços Sale Request & Exclusion]
A requisição do serviço de /sale/request/{id} retornará os resultados da sua solicitação conforme exemplo abaixo:
{
"total": 2,
"errors": 1,
"processed": 1,
"results":[
{
"id":"4566384#0101",
"row_id":123456, // ID interno do processo de conciliação
"msg": None // Ocorreu tudo certo sem problemas
},
{
"id":"9826837#0101",
"row_id":"",
"msg":"Lançamento já reconciliado." // Lançamento já conciliado anteriormente
}
]
}