Realizar atualização da integração de verbas - Histórico de revisão

Renatolima: /* Regras de Negócios */

2026-07-17T11:52:25Z

Regras de Negócios

Renatolima: /* Solução */

2026-07-17T11:41:51Z

Solução

Renatolima: /* Necessidade */

2026-07-17T11:41:21Z

Necessidade

Renatolima: Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 17/07/2026 || Renato Lima || Criação do documento |- |} == Necessidade == == S...'

2026-07-17T11:29:40Z

Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 17/07/2026 || Renato Lima || Criação do documento |- |} == Necessidade == == S...'

Página nova

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 17/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==

== Regras de Negócios ==

'''[RN01] –'''

'''[RN02] –'''

'''[RN03] –'''

'''[RN04] –'''

'''[RN05] –'''

'''[RN06] –'''

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

=== GeoSales ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

← Edição anterior		Edição das 11h41min de 17 de julho de 2026
Linha 17:		Linha 17:

	== Solução ==		== Solução ==
		+	Será realizada a evolução da API de integração de pedidos para disponibilizar, no retorno em formato JSON, as informações referentes às verbas vinculadas ao pedido.
		+
		+	A implementação contemplará a inclusão de uma estrutura específica para verbas dentro do objeto do pedido, contendo os mesmos dados atualmente disponibilizados pela view utilizada pelo cliente, preservando a consistência das informações já consumidas pelo processo de integração.
		+
		+	Com essa alteração, o integrador poderá obter todas as informações necessárias por meio da API, sem necessidade de consultas adicionais ao banco de dados, mantendo o padrão de comunicação baseado em serviços REST e simplificando a manutenção das integrações futuras.

	== Regras de Negócios ==		== Regras de Negócios ==

← Edição anterior		Edição das 11h41min de 17 de julho de 2026
Linha 10:		Linha 10:

	== Necessidade ==		== Necessidade ==
		+	O cliente utiliza a funcionalidade de verbas vinculadas aos pedidos e atualmente realiza a integração dessas informações por meio de uma view disponibilizada no banco de dados, consumida por seu processo de integração com o ERP.
		+
		+	Com a evolução da arquitetura de integração para utilização exclusiva de APIs REST, o cliente necessita que as informações das verbas lançadas nos pedidos também sejam disponibilizadas através da API em formato JSON, eliminando a dependência de acesso direto ao banco de dados e padronizando o processo de integração.
		+
		+	Essa necessidade permitirá que todas as informações relacionadas ao pedido, incluindo as verbas aplicadas, sejam consumidas por um único mecanismo de integração, garantindo maior segurança, padronização e aderência à arquitetura atual do cliente.

	== Solução ==		== Solução ==

@@ Linha 25: / Linha 25: @@
 == Regras de Negócios ==
-'''[RN01] –'''
+'''[RN01] –''' As verbas vinculadas ao pedido deverão ser disponibilizadas no retorno da API de pedidos em formato JSON.
-'''[RN02] –'''
+'''[RN02] –''' O retorno das verbas deverá conter todas as informações atualmente disponibilizadas pela view utilizada pelo processo de integração, garantindo compatibilidade com a implementação existente.
-'''[RN03] –'''
+'''[RN03] –''' Para pedidos que não possuírem verbas associadas, a API deverá retornar a estrutura de verbas vazia (array vazio), mantendo o padrão do contrato da API.
-'''[RN04] –'''
+'''[RN04] –''' Cada verba vinculada ao pedido deverá ser retornada como um objeto individual dentro da coleção de verbas do pedido.
-'''[RN05] –'''
+'''[RN05] –''' A API deverá refletir o estado atual das verbas registradas no sistema no momento da consulta, considerando inclusões, alterações e exclusões já efetivadas.
-'''[RN06] –'''
+'''[RN06] –''' A inclusão das informações de verbas não deverá alterar o comportamento atual da API para consumidores que não utilizam esse novo conjunto de dados, preservando a compatibilidade com integrações existentes.
 == Aprovação ==