# WSDL > WSDL é um documento em formato XML que descreve um serviço web baseado em SOAP: quais operações ele oferece, que dados cada operação recebe e devolve, como as mensagens devem ser montadas e em qual endereço o serviço está disponível. Funciona como um manual técnico que os sistemas leem para saber como conversar com o serviço. **Também conhecido como:** Arquivo WSDL, Descritor de serviço web, Contrato WSDL, WSDL, Web Services Description Language **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** W ## O que significa WSDL? WSDL é a sigla de Web Services Description Language, ou Linguagem de Descrição de Serviços Web. Trata-se de um padrão para escrever, em XML, a descrição completa de um serviço que pode ser acessado pela internet. Na prática, o WSDL é um arquivo que fica publicado junto ao serviço. Quem quer usar o serviço consulta esse arquivo para entender o que pode pedir, em que formato deve enviar os dados e o que vai receber de volta. ## Para que serve o WSDL? O WSDL funciona como um contrato entre quem oferece o serviço e quem o consome. Ele define com precisão as regras da conversa, evitando que cada desenvolvedor precise adivinhar nomes de campos, tipos de dados ou endereços. Outra vantagem é a automação: muitas linguagens de programação têm ferramentas que leem o WSDL e geram automaticamente o código necessário para chamar o serviço. Assim, o programador trabalha com funções prontas em vez de montar cada mensagem XML manualmente. ## Como é a estrutura de um WSDL? Um WSDL costuma ser dividido em blocos. Os tipos (types) descrevem os dados, geralmente usando um esquema XML. As mensagens (messages) indicam o que é enviado e recebido. As operações (agrupadas em portType ou interface) listam as ações disponíveis, como autorizar ou consultar. Há ainda o binding, que informa o protocolo e o formato usados, normalmente SOAP sobre HTTP, e o service, que aponta o endereço real (endpoint) onde o serviço responde. Juntos, esses blocos dizem o que o serviço faz, como falar com ele e onde encontrá-lo. ## Onde o WSDL aparece na emissão de documentos fiscais? Os web services das SEFAZ usados para NF-e, NFC-e, CT-e e MDF-e são baseados em SOAP e descritos por WSDLs. Cada serviço, como autorização, consulta de protocolo, status do serviço e recepção de eventos, tem seu próprio endereço e sua descrição. Muitas prefeituras também oferecem a emissão de NFS-e por web services SOAP com WSDL, e cada uma pode ter estrutura, operações e regras diferentes. Por isso, quem integra diretamente com vários municípios precisa lidar com diversos WSDLs, além de certificado digital e conexão segura exigidos pelos órgãos. ## Qual a diferença entre WSDL e OpenAPI? Os dois descrevem serviços, mas para estilos diferentes. O WSDL descreve serviços SOAP, que trocam mensagens em XML. O OpenAPI descreve APIs REST, que geralmente trocam dados em JSON e usam os métodos do HTTP, como GET e POST. Em termos de uso, o OpenAPI é mais comum em APIs modernas e costuma ser exibido em documentações interativas, como o Swagger UI. O WSDL segue presente em sistemas governamentais e corporativos mais antigos, onde o SOAP ainda é o padrão. ## Preciso lidar com WSDL ao usar uma API fiscal? Depende de como a integração é feita. Quem conecta seu sistema diretamente à SEFAZ ou às prefeituras precisa ler os WSDLs, gerar clientes SOAP e acompanhar mudanças de endereços e leiautes. Ao usar uma API fiscal REST, como a do Conota, essa camada fica com o provedor. O sistema do cliente envia dados em JSON para um único endpoint, e a comunicação SOAP com os órgãos autorizadores acontece nos bastidores. ## Exemplos de WSDL - Um desenvolvedor de ERP importa o WSDL do serviço de NFS-e de uma prefeitura em sua ferramenta de programação, que gera automaticamente as classes para enviar o lote de RPS e consultar o resultado. - Durante testes no ambiente de homologação, a equipe acessa o endereço do serviço de autorização da NF-e com o sufixo ?wsdl para verificar quais operações estão disponíveis e qual é o formato esperado da mensagem. - Após uma nota técnica, um órgão autorizador altera a versão de um web service, e a equipe de integração precisa atualizar o cliente gerado a partir do novo WSDL para continuar emitindo. - Uma plataforma de vendas que emite NFS-e em vários municípios troca as integrações SOAP individuais por uma API REST de emissão fiscal, deixando de manter dezenas de WSDLs diferentes. ## Perguntas frequentes ### WSDL é a mesma coisa que SOAP? Não. SOAP é o protocolo que define o formato das mensagens trocadas entre os sistemas. O WSDL é o documento que descreve um serviço SOAP: suas operações, mensagens e endereço. Um descreve, o outro é usado na comunicação. ### Onde encontro o WSDL de um serviço? Normalmente, ele é publicado pelo próprio provedor do serviço. Em muitos casos, basta acrescentar ?wsdl ao endereço do web service. Órgãos fiscais costumam divulgar os endereços em seus portais e manuais de integração. ### O WSDL substitui o esquema XML (XSD)? Não. O WSDL descreve o serviço como um todo e geralmente referencia esquemas XML para definir os dados. Na emissão fiscal, os XSDs do leiaute validam o conteúdo do documento, enquanto o WSDL define como enviá-lo. ### Preciso conhecer WSDL para usar o Conota? Não. O Conota funciona por API REST com dados em JSON. A comunicação SOAP com SEFAZ e prefeituras, incluindo o uso dos WSDLs, é tratada pela própria infraestrutura de emissão. ## Termos relacionados - [SOAP](https://conota.dev/glossario/soap.md) - [Esquema XML](https://conota.dev/glossario/esquema-xml.md) - [Endpoint de API](https://conota.dev/glossario/endpoint-de-api.md) - [OpenAPI](https://conota.dev/glossario/openapi.md) - [Namespace XML](https://conota.dev/glossario/namespace-xml.md) - [REST](https://conota.dev/glossario/rest.md) --- Fonte: [WSDL](https://conota.dev/glossario/wsdl/) · Atualizado em 2026-10-22