Guia · parceiros

Integrações de terceiros

Loja virtual, agenda ou ERP de parceiro podem cadastrar clientes, criar e consultar OS, cancelar OS ainda não faturadas, ler o catálogo e receber os avisos das OS que criaram.

Para terceiros, o faturamento normalmente acontece na tela do Cuidaro, pela empresa, com os meios de cobrança que ela já usa. Os avisos fiscais chegam ao seu sistema do mesmo jeito.

Liquidação externa vem desligada

Faturar pela API dá baixa no financeiro da empresa com base no que o seu sistema informa. Por isso só o dono ou administrador libera, escolhendo a conta onde o dinheiro entra. O Cuidaro não confere o pagamento no gateway. A liberação pode ser retirada a qualquer momento.

Boas práticas

• Uma integração por sistema, com escopos mínimos.
• Gere a Idempotency-Key uma vez por operação de negócio e reenvie a mesma em falha de rede (Idempotência).
• Trate erros pelo code, nunca pelo texto de detail (Erros).
• Ao receber 429, respeite Retry-After (Paginação e limites).
• Não registre em log segredos, tokens nem dados pessoais.

Suporte

Escreva para suporte@cuidaro.com.br com client_id, data e hora com fuso, método e caminho, status, code e instance do erro e a Idempotency-Key. Nunca envie segredos ou tokens.