01. DADOS GERAIS

Produto:

TOTVS Agro Comercialização

Linha de Produto:

Linha Protheus

Segmento:

Agroindústria

Módulo:

AGRODISTRIBUIDOR ( SIGAAGD)

Função:

AGDA120 - Cadastro de Receita

País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DAGRODIST-2564


02. SITUAÇÃO/REQUISITO

Necessidade de existir uma Mensagem Única EAI (JSON) padronizada para a rotina de Cadastro de Receita / Itens de Receita (AGDA120), a fim de permitir seu uso de maneira uniforme e reaproveitável nos processos de integração internos e externos.

03. SOLUÇÃO

Foi criada uma estrutura JSON padronizada para representar os dados da Receita (NE6) e Itens da Receita (NE7) dentro do processo de EAI do AGDA120.

A mensagem segue um formato único, eliminando divergências entre integrações e garantindo consistência na leitura e no tratamento dos dados.


Exemplo de Estrutura JSON Padronizada:

{
  "Header": {
    "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "Type": "BusinessMessage",
    "SubType": "event",
    "Event": "upsert",
    "Transaction": "AGDA120",
    "StandardVersion": "1.000",
    "Version": "1.000",
    "SourceApplication": "XXXXX",
    "CompanyId": "XX",
    "BranchId": "XXXXX",
    "Enterprise": "XX",
    "BusinessUnit": "XX",
    "ProductName": "Protheus",
    "ProductVersion": "12",
    "GeneratedOn": "YYYY-MM-DDTHH:MM:SSZ",
    "DeliveryType": "Async"
  },
  "Content": {
    "Entity": "AGDA120",
    "Event": "upsert",
    "InternalId": "XX|XXXXX|XXXXXXXXXX",
    "ExternalId": "",
    "CompanyId": "XX",
    "BranchId": "XXXXX",
    "ReceiptId": "XXXXXXXXXX",
    "ExternalReceiptId": "",
    "CustomerCode": "XXXXXX",
    "CustomerStore": "XX",
    "ReceiptNumber": "",
    "IssueDate": "YYYY-MM-DDTHH:MM:SS",
    "IssueTime": "",
    "InvoiceNumber": "",
    "InvoiceSeries": "",
    "Status": "",
    "SourceOrder": "",
    "ReceiptUrl": "",
    "Culture": "",
    "Notes": "",
    "Items": [
      {
        "ItemSequence": "001",
        "ProductCode": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "Quantity": 0,
        "AvailableQuantity": 0
      },
      {
        "ItemSequence": "002",
        "ProductCode": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "Quantity": 0,
        "AvailableQuantity": 0
      }
    ]
  }
}

04. DEMAIS INFORMAÇÕES

Não se aplica

05. ASSUNTOS RELACIONADOS

Não se aplica