Evitar operações duplicadas

A idempotência é uma técnica que garante que uma operação aconteça uma única vez, não importa quantas vezes a mesma requisição seja repetida. Ela é útil para evitar duplicados quando uma conexão cai no meio de um POST.

Status atual: a API v1 do Cord ainda não expõe um header Idempotency-Key. Enquanto o adicionamos, use as estratégias a seguir para evitar duplicados na sua integração.

Estratégias recomendadas

• Guarde o id da resposta. Quando você cria um orçamento (POST /api/v1/cotizaciones), a resposta traz data.id e data.folio. Persista esses valores no seu sistema e não repita a requisição se você já tem um id para essa operação lógica.
• Verifique antes de tentar de novo. Se um POST falhar por timeout, consulte primeiro com um GET (por exemplo, a lista de orçamentos recentes) para ver se a criação de fato aconteceu antes de enviá-la novamente.
• Aproveite a deduplicação do importador. A importação de clientes deduplica por RFC ou nome, e a de produtos por SKU. Se você sincroniza catálogos, importar de novo não cria duplicados.

Quando publicarmos o suporte oficial a Idempotency-Key, atualizaremos este guia com o header e as regras dele.