Desenvolvedor WebService
Consulte aqui informações importantes para o desenvolvimento de web services para integração de sistemas próprios com o sistema da NFS-e da Prefeitura do Município de São Paulo.
Por meio do Web Service é possível automatizar o processo de emissão, consulta e cancelamento de NF-e e emissão de guia de pagamento.
| Atenção usuários do WebService de NFS-e: Recomendação sobre o uso da interface assíncrona no WebService |
|---|
|
Através desta interface, os prestadores de serviços poderão enviar lotes de RPS emitidos por seus sistemas de forma assíncrona para que sejam substituídos por Notas Fiscais Eletrônicas. É semelhante à interface síncrona, contudo, ao invés de retornar as informações do lote, é retornado um protocolo, para posterior consulta da situação. Esta interface pode ser utilizada por todos os contribuintes, sendo fortemente recomendada aos prestadores que desejam emitir NFS-e em volumes acima de 100 mil notas/mês. Entre as vantagens do uso da interface assíncrona podem ser citadas: envio simultâneo de lotes de RPS; capacidade para envio de mais de 50 RPS por lote (limitado pelo tamanho do XML); não precisar aguardar a finalização do processamento para se obter o retorno, uma vez que ele já recebe o protocolo de que a chamada foi recebida pelo sistema; redução no risco de falha de processamento e otimização dos recursos dos sistemas. Recomendamos que seja evitado o envio de lote com apenas 1 nota. Recomendamos também que as adaptações de layout para emissão de NFS-e a partir de 01 de Janeiro de 2026 em decorrência da Reforma Tributária sejam realizadas considerando a interface assíncrona para a emissão de grandes volumes de notas. Esclarecemos ainda que a interface assíncrona permite a emissão de NFS-e, consulta da situação do lote, teste de validação de envio e emissão de guia de pagamento. Para mais informações, consulte o Manual de Utilização do Webservice de NFS-e. |
| WebService síncrono | WebService assíncrono |
|---|---|
| Envio de RPS | Envio de Lote de RPS – Assíncrono |
| Envio de Lote de RPS | Consulta Situação de Lote de RPS |
| Teste de Envio de Lote de RPS | Teste de Envio de Lote de RPS – Assíncrono |
| Consulta de NFS-e | Emissão de Guia – Assíncrono |
| Consulta de NFS-e Recebidas | Consulta Situação |
| Consulta de NFS-e Emitidas | Emissão de Guia |
| Consulta de Lote | Consulta Guia |
| Consulta de Informações de Lote | |
| Cancelamento de NFS-e | |
| Consulta de CNPJ |
Baixe aqui os Schemas XML (arquivo XSD) correspondentes a cada uma das mensagens XML de pedido e de retorno utilizadas pelo WebService LoteNFe :
a) NFS-e emitidas até 22/02/2015
b) NFS-e emitidas a partir de 23/02/2015 (fato gerador até 31/12/2025)
c) NFS-e emitidas pelo serviço assíncrono
d) NFS-e – Reforma tributária 2026 (serviços síncronos e assíncronos) – Atualizado em 06/10/2025!
Para consultar as principais dúvidas sobre a utilização do WebService: