Documentação feita para pessoas e para a IA que programa com você.
Comece no sandbox, trate serviço como catálogo e use a referência estável da sua cobrança. Envie o endereço que sua aplicação já validou; a TOOB resolve o IBGE pelo CEP e cuida da esteira fiscal.
Integre com IA
Dê o contrato certo para o seu agente.
Este prompt aponta a IA para a fonte canônica e define as regras que ela não deve adivinhar. O bloco já pode ser copiado.
prompt
Leia https://api.notas.toob.com.br/llms-full.txt e integre a API TOOB Notas.\nUse apenas TOOB_API_KEY em variável de ambiente e comece pelo sandbox.\nNo sandbox, crie ou liste um serviço de teste e persista TOOB_SERVICE_ID_TEST. Em live, pare e peça o serviço fiscal já configurado.\nNo happy path, envie CPF/CNPJ, nome, CEP, logradouro, número e bairro no customer. A TOOB resolve o IBGE pelo CEP; customer_id é opcional.\nUse reference estável para a cobrança; nunca Idempotency-Key.Escolha seu caminho
Comece com IA
Prompt, sandbox e um caminho seguro até a primeira emissão.
Modele seu catálogo
Serviço criado no painel ou criado pela API: os dois fluxos.
Leia o contrato
Schemas, exemplos de request e response, erros e estados.
Receba eventos
Assinatura, retries e payloads de nfse.issued, rejected e cancelled.