Guia

Serviços são o seu catálogo fiscal.

A emissão só recebe o identificador de um serviço. Assim o time fiscal pode configurar códigos e tributação uma vez, enquanto sua aplicação apenas referencia o item correto.

Catálogo no painel

Liste GET /v1/services, associe o srv_... ao seu produto e use-o nas emissões.

Catálogo pela API

Liste antes; se faltar, crie uma vez com POST /v1/services, persista o id retornado e altere conscientemente com PATCH.

Criando via API

json

{\n  "name": "Consultoria mensal",\n  "description": "Consultoria de software",\n  "municipality_code": "3550308",\n  "municipal_tax_code": "02804",\n  "municipal_taxation": "T",\n  "default_amount_cents": 150000\n}

Depois de criado, use o id retornado como service_id. A API não deduplica POSTs de serviço: se sua integração processa eventos concorrentes, faça essa primeira criação sob lock ou transação local. Uma nota pode sobrescrever apenas a descrição para detalhar o período, sem mudar códigos ou regras fiscais.

Ambiente importa. Atualizar um serviço altera apenas novas emissões. Notas já emitidas preservam o snapshot usado na autorização, e um srv_... de sandbox não funciona em live: cadastre ou liste o equivalente depois de trocar a chave.

Ver emissão completa