Guia técnico de emissão de NFS-e em Costa Rica/MS pela API da Focus NFe

Saiba como emitir NFS-e em Costa Rica (MS) pela API da Focus NFe. Este guia é voltado para clientes e para quem está testando a nossa API. Aqui, você encontra os campos obrigatórios, exemplos e observações específicas para desenvolvedores.

Informações Gerais

Empresas MEI e optantes pelo Simples Nacional possuem prazos definidos para deixar de emitir utilizando este ambiente municipal. Consulte a obrigatoriedade de emissão no Ambiente Nacional.

Este município utiliza o formato nacional da NFSe, mas não opera no Ambiente Nacional.

Para emitir NFSe neste município, utilize o layout nacional e o endpoint v2/nfsen.

Não habilite a opção "Ambiente da NFSe Nacional" no painel da API.
A emissão deve ser feita pela API padrão de NFSe, mantendo apenas essa opção ativa no painel.

Provedor

Fiorilli

Formato

Nacional

Autenticação

Certificado digital

Cancelamento

Não permite por webservices Apenas via portal / requisição na prefeitura

Ambientes Disponíveis

Ambiente

Disponível

Portal de Acesso

Produção

Sim

Acessar

Homologação

Sim

Não disponível

Campos do Provedor

Chave NFS-e rejeitada

$.chave_nfse_rejeitada /nfse1:chNFSeRej

Reforma

Chave de Acesso da NFS-e rejeitada pelo Tomador/Intermediário

Motivo da Emissão

$.motivo_emissao /nfse1:cMotivoEmisTI

Reforma

Motivo da Emissão da DPS pelo Tomador/Intermediário
Valores possíveis:
1 - Importação de Serviço;
2 - Tomador/Intermediário obrigado a emitir NFS-e por legislação municipal;
3 - Tomador/Intermediário emitindo NFS-e por recusa de emissão pelo prestador;
4 - Tomador/Intermediário emitindo por rejeitar a NFS-e emitida pelo prestador.

Outras Informações

Requer liberação de RPS com a prefeitura
- Liberação pode ser consultada no portal: Contribuinte > Dados Gerais > Mobiliário > Autorizado a emitir RPS

JSONs de Exemplo

{
  "data_emissao": "2026-08-04T07:34:56-0300",
  "data_competencia": "2026-08-04",
  "codigo_municipio_emissora": 5003256,
  "cnpj_prestador": "00000000000000",
  "inscricao_municipal_prestador": "123445",
  "codigo_opcao_simples_nacional": 3,
  "regime_tributario_simples_nacional": 1,
  "regime_especial_tributacao": 0,
  "cnpj_tomador": "11.111.111/0001-11",
  "razao_social_tomador": "Fictício Tomador",
  "codigo_municipio_tomador": 5003256,
  "cep_tomador": "79550000",
  "logradouro_tomador": "Rua Fictícia",
  "numero_tomador": "1234",
  "complemento_tomador": "ap02",
  "bairro_tomador": "CENTRO",
  "telefone_tomador": "11 1111-1111",
  "email_tomador": "test@example.com",
  "codigo_municipio_prestacao": 5003256,
  "codigo_tributacao_nacional_iss": "050801",
  "descricao_servico": "Teste de emissão de NFSe",
  "valor_servico": 1.0,
  "percentual_aliquota_relativa_municipio": 2.01,
  "tributacao_iss": 1,
  "tipo_retencao_iss": 1,
  "indicador_total_tributacao": "0",
  "codigo_nbs": "1.1405.60.00"
}