Manual de integração com o webservice
Portais Disponíveis
- Produção
Métodos Disponíveis
- Envio.
- Assíncrono
- Consulta de Lote.
- Consulta de NFSe por RPS.
- Consultar Notas Tomadas.
- Cancelamento de NFSe.
Observações
- Não aceita envio síncrono.
-
O método ConsultarNotasTomadas é utilizado pelos tomadores de serviços para consultar notas emitidas contra o CNPJ / CPF deles.
-
O método possui os parâmetros: ("Nome da Cidade", "Documento do Prestador", "Inscrição municipal do tomador", "Documento do Prestador ou consulente", "Inscrição municipal do prestador ou do consulente",
"Data Inicial da emissão das notas", "Data Final da emissão das notas", "Número da Pagina pois quando possui muitas notas a consulta é dividida em páginas'') - Caso o Documento do Prestador ou Consulente não for informado, o documento do Tomador será informado no lugar.
-
O método possui os parâmetros: ("Nome da Cidade", "Documento do Prestador", "Inscrição municipal do tomador", "Documento do Prestador ou consulente", "Inscrição municipal do prestador ou do consulente",
Impressão: Não é possível realizar a impressão com QR Code da prefeitura, pois o link não é compatível com impressão externa.
Atualização de Outubro/2026 – Reforma Tributária (IBS/CBS) e PIS/COFINS (NT 007)
Em 05/10/2026, o padrão SIMPLISS20 publicou um complemento ao manual do Web Service (ABRASF 2.03), com os novos campos para a Reforma Tributária e para as regras de PIS/COFINS da NT 007.
IBS/CBS
Foi incluído o grupo opcional IBSCBS dentro de Serviço, logo após a tag CodigoNbs e antes da Discriminação. O grupo é composto pelos campos CodigoCST, CodigoClassificacaoTributaria e cIndOp.
Observação: os códigos acima são apenas exemplos de preenchimento estrutural. Não representam uma indicação fiscal para uma operação específica. O contribuinte deve informar os códigos correspondentes à operação, conforme as tabelas oficiais vigentes.
PIS/COFINS — apuração própria e retenções (NT 007)
Com a atualização, o Web Service passou a tratar separadamente os valores de PIS e COFINS de apuração própria do prestador e os valores retidos.
Apuração própria: os valores de PIS e COFINS correspondentes à apuração própria são informados nos campos ValorPisApuracaoPropria e ValorCofinsApuracaoPropria.
Retenções: as retenções de PIS, COFINS e CSLL são tratadas como Contribuições Sociais Retidas, e o tipo de retenção é indicado em TpRetPisCofins.
Novos campos disponibilizados após a adequação da Reforma Tributária
| NumeroLote | QuantidadeRps | CpfCnpjRemetente | InscricaoMunicipalRemetente |
| NumeroRps | SerieRps | TipoRps | DataEmissao |
| SituacaoNota | Competencia | ValorServicos | ValorDeducoes |
| ValorInss | ValorIr | ValorCsll | ValorPis |
| ValorCofins | ValorPisProprio | ValorCofinsProprio | TipoRetPisCofins |
| OutrasRetencoes | DescontoIncondicionado | DescontoCondicionado | ValorISS |
| AliquotaISS | IssRetido | ResponsavelRetencao | CodigoItemListaServico |
| CodigoCnae | CodigoTributacaoMunicipio | DiscriminacaoServico | CodigoCidadePrestacao |
| CodigoPais | ExigibilidadeIss | MunicipioIncidencia | CpfCnpjPrestador |
| InscricaoMunicipalPrestador | RegimeEspecialTributacao | OptanteSimplesNacional | IncentivoFiscal |
| RazaoSocialTomador | CpfCnpjTomador | InscricaoMunicipalTomador | DocTomadorEstrangeiro |
| EnderecoTomador | NumeroTomador | ComplementoTomador | BairroTomador |
| CodigoCidadeTomador | UfTomador | CepTomador | PaisTomador |
| DDDTomador | TelefoneTomador | EmailTomador | CpfCnpjIntermediario |
| InscricaoMunicipalIntermediario | RazaoSocialIntermediario | CodigoObra | Art |
| CodigoNbs | SituacaoTributariaIbsCbs | ClassificacaoTributariaIbsCbs | CodigoOperacao |
Para maiores informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.
Geração do XML - Campos Importantes
- O código do serviço segue o que está descrito na LC-116.
- Padrão faz uso do código CNAE.
- Alíquota não é um campo obrigatório.
-
(Componente) As informações da Reforma Tributária só são geradas no XML quando informado
VersaoEsquema=RTCno TX2.
Campos customizados para a impressão
Impressão do RPS
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- InscricaoEstadualPrestador=String[80]
- EnderecoPrestador=String[80]
- NumeroPrestador=String[7]
- ComplementoPrestador=String[20]
- BairroPrestador=String[40]
- CodigoCidadePrestador=String[10]
- UfPrestador=String[2]
- CepPrestador=String[8]
- TelefonePrestador=String[20]
- EmailPrestador=String[80]
- InscricaoEstadualTomador=String[80]
- NifTomador=String[80]
- Tributacao=String[80]
- OutrasInformacoes=String[100]
- BaseCalculoIbsCbs=String[20]
- ValorCbs=String[20]
- ValorIbsEstadual=String[20]
- ValorIbsMunicipal=String[20]
Impressão da NFSe
- InscricaoEstadualPrestador=String[80]
- InscricaoEstadualTomador=String[80]
- InscricaoMunicipalTomador=String[80]
- NifTomador=String[80]
- CodigoCnae=String[10]
- ValorTotalTributos=String[10]
- Tributacao=String[80]]
- OutrasInformacoes=String[100]
- BaseCalculoIbsCbs=String[20]
- ValorCbs=String[20]
- ValorIbsEstadual=String[20]
- ValorIbsMunicipal=String[20]
Soluções Tecnospeed
- Componente NFSe: Release 10.1.72.X
Comentários
0 comentário
Por favor, entre para comentar.