Guias

Problemas comuns

Nota recusada pelo código do serviço

No Emissor Nacional, o serviço do catálogo precisa do código de tributação nacional com 6 dígitos (ex.: 01.03.01), que não é o item da LC 116 (1.03). A empresa corrige em Serviços → Catálogo e reemite pela tela da OS.

E0314: código de tributação municipal inexistente

Deixe vazio o código de tributação municipal do serviço, que é opcional e só existe quando o município tem tabela própria.

E0120: inscrição municipal do prestador

O município não registrou informações complementares no cadastro nacional. A empresa mantém desmarcada, em Fiscal → NFS-e, a opção de informar a inscrição municipal no Nacional e sincroniza com o emissor.

E0625: alíquota informada para ME/EPP do Simples

A empresa não precisa fazer nada. No Emissor Nacional, para empresa do Simples que apura o ISS pelo Simples (regime 1) e serviço sem retenção de ISS, o Cuidaro omite a alíquota, como a Sefin exige. Nota recusada antes da correção é reemitida pela tela da OS.

Cliente sem código IBGE

invoice responde 422 com erro em contact.address.city_ibge_code. Reenvie o cliente com endereço completo e IBGE de 7 dígitos e repita o invoice com chave nova.

409 IDEMPOTENCY_KEY_IN_PROGRESS

Em contacts e service-orders, espere e reenvie igual. Em invoice e cancel, consulte a OS e, se a operação não aconteceu, reenvie com chave nova. Veja Idempotência.

Token expirado ou credencial inválida

401 AUTH_TOKEN_EXPIRED: peça outro token. 401 AUTH_CREDENTIALS_INVALID na emissão: o segredo foi trocado ou a integração revogada. Veja Autenticação.