# OS 105677 - MELHORIA - DOC. ELETRÔNICO - INCLUSÃO DA TAG CODOBRA NO LAYOUT DO WEB SERVICE VINHEDO #### **Objetivo** Disponibilizar o vínculo da obra nos objetos do contrato e garantir que o código informado seja propagado para o pedido e para a nota fiscal gerada pelo faturamento do contrato, permitindo sua utilização na TAG **``** do XML do Web Service de Vinhedo. #### **Premissas** - Necessário o ambiente estar atualizado com as versões: - Módulo **Contratos** de número **151084 / 151088** ou superior; - Módulo **Doc. Eletrônico** de número **150664 / 150674** ou superior; - Módulo **Scripts** de número **SQL: 149319 / Postgres: 149320** ou superior; - Funcionalidade **`HABILITA_WEBSERVICE_VINHEDO`** precisa estar ativa via banco de dados, caso necessário entre em contato com a Send Solutions. - O participante utilizado no contrato deve possuir obra cadastrada em **Fiscal > EFD-REINF > Parametrização de parceiros**. - Para os testes de homologação, utilizar o código de obra **`000000000106`**, cadastrado no sistema da Prefeitura de Vinhedo. - O cadastro de séries para notas de serviço deve estar devidamente parametrizado. - Antes do teste, deve ser verificado o último número de nota gerado no sistema da Prefeitura de Vinhedo e atualizado o cadastro de séries. - No módulo **Documento Eletrônico**, acesse **Configuração > Cadastro de Parâmetros**, atualize as Notas Técnicas e confirme que a Nota Técnica **`2026 - TAGS CODOBRA`** está disponível para o tipo de documento **RPS\_Vinhedo**. [![codex-clipboard-6cffc939-1c87-4db8-9c19-34739c970715.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/QExIAkvSxGLeLY2d-codex-clipboard-6cffc939-1c87-4db8-9c19-34739c970715.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/QExIAkvSxGLeLY2d-codex-clipboard-6cffc939-1c87-4db8-9c19-34739c970715.png)

**ATENÇÃO:** Não houve alteração nas telas ou processos utilizados exclusivamente para as parametrizações iniciais.

#### **Cenário 01: Validar disponibilização dos campos de obra no objeto do contrato** **Objetivo:** Validar a inclusão dos campos **Indicativo de Obra** e **Código de Obra** na guia **Objetos** do cadastro de contratos. **Pré-condição:** - Funcionalidade **`HABILITA_WEBSERVICE_VINHEDO`** habilitada. - Tipos de participantes do contrato devidamente cadastrados. - Participante com obra cadastrada no módulo Fiscal. - Utilizar preferencialmente a obra **`000000000106`** para homologação.

**Resultado Esperado:** Ao inserir ou editar um objeto do contrato, o sistema deve disponibilizar os campos **Indicativo de Obra** e **Código de Obra**. Na pesquisa do Código de Obra, devem ser apresentadas as obras cadastradas no módulo Fiscal correspondentes ao **primeiro participante ativo** que possua o tipo de documento parametrizado diferente de **“NENHUM”**. A obrigatoriedade dos campos **Inscrição do Imóvel** e **Cadastro Imobiliário** deve ser apresentada conforme a configuração do Indicador de Operação, sem exibir **“SIM”** indevidamente quando não houver obrigatoriedade definida.

**Passo a passo:** 1. Acesse o módulo **Fiscal**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/joO34m3JhYbhYI2A-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/joO34m3JhYbhYI2A-image.png) 2. Acesse **EFD-REINF > Parametrização de parceiros**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/IckWw68ixmhNQfvU-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/IckWw68ixmhNQfvU-image.png) 3. Localize o participante que será utilizado no contrato. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/4Xl4ocbRjX96bLQD-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/4Xl4ocbRjX96bLQD-image.png) 4. Consulte as obras cadastradas para o participante. 5. Certifique-se de que a obra **`000000000106`** esteja disponível para utilização no teste. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/PYBKNoOM43hNEitH-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/PYBKNoOM43hNEitH-image.png) 6. Acesse o módulo **Gestão de Contratos**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/cTYcnV51YpKdJVlk-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/cTYcnV51YpKdJVlk-image.png) 7. Acesse **Gestão de Contratos > Contratos**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/BF0RG98QvrnbYGrs-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/BF0RG98QvrnbYGrs-image.png) 8. Insira um novo contrato. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/kgFobI8vp6G9hLDt-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/kgFobI8vp6G9hLDt-image.png) 9. Selecione o tipo de contrato. 10. Informe o número e confirme. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/0rR42dKyaPz8wvJ0-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/0rR42dKyaPz8wvJ0-image.png) 11. Preencha as informações do contrato. 12. Insira os participantes. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/sn3JbYE4Htt5rNul-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/sn3JbYE4Htt5rNul-image.png) 13. Informe os dados do responsável. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/eMSgS830EpZE8PHZ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/eMSgS830EpZE8PHZ-image.png) 14. Acesse a guia **Objetos**. 15. Clique para inserir um objeto. 16. Verifique a apresentação dos campos **Indicativo de Obra** e **Código de Obra**. 17. Acione a pesquisa do Código de Obra. 18. Verifique as obras apresentadas. 19. Selecione a obra **`000000000106`**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/bm05RnJaUjbnp3xa-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/bm05RnJaUjbnp3xa-image.png) 20. Confirme o objeto. 21. Verifique se o objeto foi incluído corretamente no contrato. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/DdWGnuclAzN2P8RG-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/DdWGnuclAzN2P8RG-image.png) #### **Cenário 02: Validar propagação do Código de Obra no faturamento do contrato** **Objetivo:** Validar que o Código de Obra informado no objeto do contrato seja propagado para o pedido e para a nota fiscal gerada durante o faturamento. **Pré-condição:** - Contrato cadastrado conforme o **Cenário 01**. - Objeto do contrato contendo o Código de Obra **`000000000106`**. - Dados necessários ao faturamento devidamente preenchidos. - Série da nota de serviço corretamente parametrizada.

**Resultado Esperado:** Ao gerar a nota fiscal a partir da medição do contrato, o sistema deve considerar o Código de Obra informado no objeto e aplicá-lo ao **pedido** e à **nota fiscal gerada**. Quando existirem diferentes códigos de obra nos objetos do contrato, deve ser considerado somente o **primeiro código de obra localizado**. Para faturamentos relacionados a obras distintas, as emissões das notas devem ser realizadas separadamente.

**Passo a passo:** 1. No contrato criado anteriormente, informe os dados necessários para faturamento. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/rtkuSM6dhXHBMuwF-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/rtkuSM6dhXHBMuwF-image.png) 2. Confirme e finalize a digitação. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/AhX7Xwm2GcBtfiBr-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/AhX7Xwm2GcBtfiBr-image.png) 3. Confirme a criação do contrato. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/9zmQLcyUHGwBKe4t-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/9zmQLcyUHGwBKe4t-image.png) 4. Acesse **Lançamentos > Medição**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/uxh5EdZxRkC7T231-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/uxh5EdZxRkC7T231-image.png) 5. Insira uma nova medição. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/sMeST59yrO89cJNQ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/sMeST59yrO89cJNQ-image.png) 6. Informe o contrato criado. 7. Confirme. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/ASA5V84MSfsCE0Pv-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/ASA5V84MSfsCE0Pv-image.png) 8. Insira o item da medição. 9. Informe a quantidade. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/qngVaABrxUcKWfQx-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/qngVaABrxUcKWfQx-image.png) 10. Preencha as demais informações necessárias. 11. Confirme e finalize a medição.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/HzGtZGvUal3yCThJ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/HzGtZGvUal3yCThJ-image.png) 12. Envie a medição para aprovação. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/V8NyKUxFJf7dkmaX-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/V8NyKUxFJf7dkmaX-image.png) 13. Acesse **Lançamentos > Aprovação de Medição**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/YOpEiYJpg27grj4w-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/YOpEiYJpg27grj4w-image.png) 14. Aprove a medição. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/XwjFNvejuvJ2G6K9-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/XwjFNvejuvJ2G6K9-image.png) 15. Confirme o retorno da medição. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/F6UsXqXsFuTSzOlo-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/F6UsXqXsFuTSzOlo-image.png) 16. Na tela de apontamento, informe a data de competência. 17. Confirme os dados. 18. Gere a nota fiscal. 19. Confirme a geração. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/whH86fl8mFNJvAl6-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/whH86fl8mFNJvAl6-image.png) [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/RQDSkUNdiEM5ZaJE-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/RQDSkUNdiEM5ZaJE-image.png) 20. Consulte o contrato faturado. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/BKAF33X666mgcpYA-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/BKAF33X666mgcpYA-image.png) 21. Identifique o número da NF gerada. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/jre6Sm0pd8ew4kiy-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/jre6Sm0pd8ew4kiy-image.png) 22. Consulte o pedido e a nota fiscal. [![Evidência da validação do Código de Obra na nota fiscal](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/og4YE59fcgClgyUU-os-105677-codigo-obra-nf-transmissao-validada.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/og4YE59fcgClgyUU-os-105677-codigo-obra-nf-transmissao-validada.png) 23. Verifique se o Código de Obra **`000000000106`** foi aplicado corretamente.

**ATENÇÃO:** O sistema Send considera somente **um item para transmissão de notas de serviço**.

#### **Cenário 03: Validar geração da TAG <codObra> no XML de Vinhedo** **Objetivo:** Validar a geração da TAG **``** no XML de transmissão de NFS-e de Vinhedo quando a nota fiscal possuir Código de Obra. **Pré-condição:** - Nota fiscal gerada pelo faturamento do contrato. - Código de Obra **`000000000106`** presente na nota. - Nota Técnica **`2026 - TAGS CODOBRA`** devidamente parametrizada para **RPS\_Vinhedo**. - Demais Notas Técnicas aplicáveis ao período do teste devidamente vigentes.

**Resultado Esperado:** Ao gerar o XML para transmissão de uma nota contendo Código de Obra, o layout do Web Service de Vinhedo deve considerar a TAG **``** com o código da obra. A transmissão deve ser validada e a nota fiscal deve apresentar o mesmo Código de Obra.

``` 000000000106 ``` **Passo a passo:** 1. Acesse o módulo **Documentos Eletrônicos**. 2. Acesse **NFS-e > Transmissão Vinhedo**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/6P1gYvP2WBIFDow1-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/6P1gYvP2WBIFDow1-image.png) 3. Localize a nota fiscal gerada no cenário anterior. 4. Selecione a nota. 5. Clique em **Gerar XML para Transmissão**. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/scaled-1680-/OnD2KbYeNJujJ0tP-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-09/OnD2KbYeNJujJ0tP-image.png) 6. Acompanhe o processamento da transmissão. 7. Verifique se a nota apresenta o status **XML Validado**. 8. Consulte a nota fiscal gerada. 9. Verifique o campo **Cód. Obra**. 10. Confirme que o valor corresponde ao Código de Obra selecionado no contrato. **Evidência:** A nota fiscal apresenta o Código de Obra informado no contrato após a validação do XML de transmissão. [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/scaled-1680-/H5TjALbrTN63b9eO-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/H5TjALbrTN63b9eO-image.png)

**Observação:** Antes de gerar o XML, certifique-se de que todas as Notas Técnicas aplicáveis à data da emissão estejam vigentes, incluindo as relacionadas às TAGs de IBS.

#### **Observações / Atenções**

**ATENÇÃO – Ambiente de homologação de Vinhedo**

O Web Service de Vinhedo no ambiente de homologação (**simulaNFE**) não está retornando o **Código de Verificação**, informação utilizada como Chave da NFS-e. Na liberação para o cliente, as primeiras transmissões em produção devem ser acompanhadas para confirmar o retorno dessa informação.

**ATENÇÃO – Homologação x Produção**

Podem existir diferenças entre os ambientes de homologação e produção do Web Service de Vinhedo. Dessa forma, as primeiras emissões em produção devem ser acompanhadas para confirmar que: - a transmissão foi concluída com êxito; - o Código de Verificação foi retornado; - a NFS-e foi devidamente registrada no sistema da Prefeitura de Vinhedo; - o Código de Obra foi enviado conforme esperado.

**ATENÇÃO – Nota Técnica**

A Nota Técnica referente ao Código de Obra possui vigência em produção a partir de **14/09**. Antes das primeiras emissões, confirme se o Web Service de Vinhedo está configurado para receber a TAG **``**.

**ATENÇÃO:** As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.

![Ficou com alguma dúvida?](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/scaled-1680-/6lDN2zESNX8VNNqd-ficou-com-alguma-duvida.png)