Para realizar atualizações (PUT) é necessário ter o ID do registro salvo no Mercos. Abaixo explicamos as formas possíveis de obter esse ID.
✅ 1. Após um POST bem-sucedido Quando você realiza uma requisição POST e recebe uma resposta HTTP 201 (Created), a API retorna no header da resposta o campo:
- MeusPedidosID: representa o identificador do novo registro salvo no Mercos.
Importante: salve esse ID logo após o recebimento da resposta. Ele será necessário para futuras operações de atualização (PUT).
🔁 2. Consultando registros existentes via GET
Caso a empresa já possua dados no Mercos, você pode utilizar um GET para buscar registros e obter os IDs existentes. A maneira mais eficiente de fazer isso é utilizando o parâmetro alterado_apos, que retorna apenas os registros modificados ou criados após uma determinada data/hora (em formato ISO 8601).
Exemplo de uso:
GET /clientes?alterado_apos=2023-01-01T00:00:00Esse endpoint retornará os clientes alterados ou criados após 1º de janeiro de 2023. A resposta incluirá o campo id, que é o identificador necessário para ações futuras com esse registro.
➡️ Próximo passo Agora que você sabe como obter os IDs dos registros, veja como consultar todos os dados paginados na seção de Paginação.