Revisar dados de serviço extraídos de XML de NFS-e
Prévia sem persistência, restrita ao administrador da empresa selecionada no token e pertencente ao licenciado. O XML pode ter sido emitido por outra empresa; issuerMatchesCompany sinaliza a divergência sem expor CPF/CNPJ. Recebe uma NFS-e emitida em UTF-8, ISO-8859-1/latin1 ou Windows-1252, até 1 MiB. Suporta Nacional 1.00/1.01, ABRASF 2.03/2.04 e GINFES v03. No formato nacional, NFSe e DPS têm versões 1.00/1.01 validadas separadamente; NFSe 1.01 pode conter DPS 1.00, e a resposta informa a versão da NFSe. Inclui a exportação individual ISS Fortaleza com NFSE/Nfse/InfNfse, namespace http://www.ginfes.com.br/tipos_v03.xsd e schemaLocation contendo https://iss.fortaleza.ce.gov.br/grpfor/schema/V2/tipos_v02.xsd. Também reconhece CompNfse/Nfse/InfNfse no namespace http://www.ginfes.com.br/servico_consultar_lote_rps_resposta_v03.xsd quando OrgaoGerador/CodigoMunicipio é 2304400, com os mesmos mapeamentos fiscais de Fortaleza descritos abaixo. Não aceita lotes, DPS/RPS avulsos, DTD ou entidades declaradas. Retorna sugestões parciais e pendências; ausência não significa zero ou falso. Alíquotas retornadas são percentuais; GINFES convencional converte sua fração para percentual. A exportação Fortaleza identificada acima já informa percentual: Aliquota 2.17 retorna aliquotISS 2.17, sem multiplicar por 100. A unidade não é inferida pela magnitude. Fortaleza retorna format=ginfes e version=3.00. Nessa exportação, NaturezaOperacao mapeia tipo de tributação/exigibilidade ClickFin: 1→6/1, 2→7/1, 3→1/3, 4→2/5; 5 e 6 preenchem somente exigibilidade 6 e 7. ExigibilidadeISS explícita divergente gera pendência ambiguous; valor inválido não usa fallback. IbsCbs.CodigoIndicadorOperacao preenche ibscbs.operationCode e IbsCbs.Valores.TributosIbsCbs.GrupoIbsCbs.CST/CodigoClassTrib preenchem ibscbs.cst/cct, preservando zeros à esquerda (6/3/6 dígitos). CodigoIndicadorOperacaoUsoConsumoPessoal aceita somente 0/1; -1 gera aviso invalid sem sugerir personalOperation. CodigoIndicadorFinalidadeNFSe não é usado como operação pessoal. Não infere alíquotas de valores monetários, regime tributário ou mínimos de retenção. Não importa certificado/senha/ambiente. Variantes com namespace Nacional ou GINFES reconhecido e estrutura de serviço inequívoca podem retornar format=other e apenas códigos/descrição do serviço. Nessas variantes, não sugere tributos sem mapeamento fiscal conhecido. Isso inclui outros envelopes GINFES v02/v03/v04 e versões nacionais sem adaptador fiscal específico. O consumidor deve permitir revisão e escolha dos campos antes de preencher o formulário e exigir revisão fiscal explícita quando o emitente for diferente, não puder ser identificado ou houver pendências de campos. A gravação usa os endpoints existentes e suas validações.
service_invoices:writeParâmetros
- companyIdpath
Sem descrição disponível.
Respostas
Dados disponíveis para revisão; nenhuma gravação foi executada.
Categories SERVICE_INVOICE.XML_IMPORT.INVALID_REQUEST, INVALID_XML, UNSUPPORTED_FORMAT ou NO_DATA (mesmo prefixo). Sem conteúdo do XML nas mensagens. MIDDLEWARE.AUTH.COMPANY_NOT_SELECTED quando o token não contém empresa selecionada.
Token ausente, inválido ou sem empresa selecionada.
SERVICE_INVOICE.XML_IMPORT.FORBIDDEN para empresa diferente da selecionada, MIDDLEWARE.ENSURE.UNAUTHORIZED_ACCESS_ADMIN_REQUIRED para perfil não administrador, ou BILLING.COMMERCIAL.ACCESS_BLOCKED para acesso comercial bloqueado.
SERVICE_INVOICE.XML_IMPORT.COMPANY_NOT_FOUND para empresa inexistente ou de outro licenciado.
SERVICE_INVOICE.XML_IMPORT.FILE_TOO_LARGE para arquivo maior que 1 MiB.
Limite de requisições excedido (RATE_LIMIT.EXCEEDED). Por chave: 120 requisições por minuto (janela fixa de 60 s); o 429 da chave traz X-RateLimit-* da chave. Por IP, para tráfego com chave: 600 requisições em 10 minutos; esse 429 traz só Retry-After, sem X-RateLimit-* (os cabeçalhos descrevem apenas o limite da chave). Aguarde Retry-After segundos antes de tentar de novo.
Credencial não pôde ser verificada por falha temporária do servidor (AUTH.SESSION_UNAVAILABLE). Não invalida a chave nem a sessão: repita com backoff.