Produto ainda em fase de piloto. |
Modelo a ser seguido para a integração de Baixas de Títulos a Pagar e/ou Receber enviados do sistema Gesplan para o Protheus.
O envio de dados deve ser realizado via SmartLink utilizando o Padrão CloudEvents para envio de mensagens no formato Json.
O job FwTotvsLinkJob deve ser configurado no schedule, ele é responsável pela leitura das mensagens recebidas na fila do SmartLink.
Abaixo temos o modelo de mensagem enviada pela Gesplan.
O atributo type indica o evento a ser executado no ERP. O job FWTotvsLinkJob identifica uma nova mensagem e executa a classe BxTreadXGsp, responsável pela baixa/cancelamento dos títulos via rotina automática (FINA070 ou FINA080, conforme especificado no atributo OperationType). O fonte que contém a classe BxTreadXGsp é o FINIBXTG.prw.
{
"specversion": "1.0",
"type": "BxTreadXGsp",
"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
"time": "2023-07-19T15:18:08.367574Z",
"data": [
{
"CompanyId": "T1",
"BranchId": "D MG 01",
"OperationType" : "R",
"OperationAction" : "B",
"E1_NUM": "200",
"E1_PREFIXO": "GES",
"E1_PARCELA": " ",
"E1_TIPO": "NF",
"AUTMOTBX": "NOR",
"AUTBANCO": "001",
"AUTAGENCIA": "00001",
"AUTCONTA": "0000000001",
"AUTDTBAIXA": "23/09/2024",
"AUTDTCREDITO": "23/09/2024",
"AUTHIST": "BAIXA TESTE",
"AUTJUROS": 0,
"AUTVALREC": 700,
"ID": "ID001",
"SYSCODE": "ID001"
}
]
} |
{
"specversion": "1.0",
"type": "BxTreadXGsp",
"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
"time": "2023-07-19T15:18:08.367574Z",
"data": [
{
"CompanyId": "T1",
"BranchId": "D MG 01",
"OperationType" : "R",
"OperationAction" : "E",
"E1_NUM": "200",
"E1_PREFIXO": "GES",
"E1_PARCELA": " ",
"E1_TIPO": "NF",
"E1_CLIENTE": "000001",
"E1_LOJA": "01",
"AUTMOTBX": "NOR",
"AUTBANCO": "001",
"AUTAGENCIA": "00001",
"AUTCONTA": "0000000001",
"AUTDTBAIXA": "23/09/2024",
"AUTDTCREDITO": "23/09/2024",
"AUTHIST": "BAIXA TESTE",
"AUTJUROS": 0,
"AUTVALREC": 700,
"ID": "ID001",
"SYSCODE": "ID001"
}
]
} |
{
"specversion": "1.0",
"type": "BXTreadXGsp",
"tenantId": "a9e9e39f-320e-4a15-a671-aa3f9145d936",
"time": "2023-07-19T15:18:08.367574Z",
"data": [
{
"CompanyId": "T1",
"BranchId": "D MG 01",
"E2_FILIAL": "D MG 01",
"E2_NUM": "20241021A",
"E2_PREFIXO": "GES",
"E2_PARCELA": "",
"E2_TIPO": "NF",
"E2_FORNECE": "000001",
"E2_LOJA": "00",
"AUTMOTBX":"NOR",
"AUTBANCO":"001",
"AUTAGENCIA": "00001",
"AUTCONTA": "0000000001",
"AUTDTBAIXA": "21/10/2024",
"AUTDTCREDITO": "21/10/2024",
"AUTHIST": "BAIXA TESTE",
"AUTJUROS": 0,
"AUTVLRPG": 350,
"OperationType": "P",
"OperationAction": "B",
"SYSCODE": "16070",
"ID": "16070"
}
]
} |
{
"specversion": "1.0",
"type": "BXTreadXGsp",
"tenantId": "a9e9e39f-320e-4a15-a671-aa3f9145d936",
"time": "2023-07-19T15:18:08.367574Z",
"data": [
{
"CompanyId": "T1",
"BranchId": "D MG 01",
"E2_NUM": "20241021A",
"E2_PREFIXO": "GES",
"E2_PARCELA": "",
"E2_TIPO": "NF",
"E2_FORNECE": "000001",
"E2_LOJA": "00",
"AUTMOTBX":"NOR",
"AUTBANCO":"001",
"AUTAGENCIA": "00001",
"AUTCONTA": "0000000001",
"AUTDTBAIXA": "21/10/2024",
"AUTDTCREDITO": "21/10/2024",
"AUTHIST": "BAIXA TESTE",
"AUTJUROS": 0,
"AUTVLRPG": 350,
"OperationType": "P",
"OperationAction": "C",
"SYSCODE": "16070",
"ID": "16070"
}
]
} |
a. Principais Campos e Parâmetros
| Campo | Descrição | Tipo | Tamanho(MAX) | Obrigatório | Observação |
|---|---|---|---|---|---|
| CompanyId | Código do Grupo de Empresas | Caractere | 2 | x | Grupo de Empresa do Protheus. Todos os movimentos da mensagem devem pertencer ao mesmo Grupo de Empresa. Caso existam movimentos de Grupos de Empresa diferentes, deverão ser enviados em mensagens separadas. |
| BranchId | Código da Filial | Caractere | 8 | x | Filial do Protheus. Identificação da filial do sistema onde ocorrerá a operação. Em ambientes com Gestão de Empresas o BranchId é composto pela Empresa + Unidade de Negócio + Filial |
| OperationType | Operação a ser realizada "P" ou "R" | Caractere | 1 | x | "P" = Título a Pagar "R" = Título a Receber |
| OperationAction | Ação de integração a ser realizada | Caractere | 1 | x | "B" = Baixa "C" = Cancelamento |
| E2_FILIAL | Código da Filial | Caractere | 8 | x | Filial do Protheus. Identificação da filial do sistema onde ocorrerá a operação. Em ambientes com Gestão de Empresas o BranchId é composto pela Empresa + Unidade de Negócio + Filial |
E1_NUM (para OperationType="R") E2_NUM (para OperationType="P") | Número do documento | Caractere | 9 | x | Será complementado com "0" (zeros) a esquerda, quando o conteúdo passado for inferior ao tamanho do campo na base de dados. |
E1_PREFIXO (para OperationType="R") E2_PREFIXO (para OperationType="P") | Prefixo de identificação do título | Caractere | 3 | x | N/A |
E1_PARCELA (para OperationType="R") E2_PARCELA (para OperationType="P") | Parcela do título | Caractere | 1 | x | Pode ser enviado conteúdo vazio. |
E1_TIPO (para OperationType="R") E2_TIPO (para OperationType="P") | Tipo | Caractere | 3 | x | Conforme tabela SX5 - NF, BOL, FT, etc. |
E1_CLIENTE E2_FORNECE | Código do Cliente Código do Fornecedor | Caractere | 6 | X | Campos obrigatórios para efetuar o cancelamento dos títulos Código do Cliente cadastrado na Tabela SA1 Código do Fornecedor cadastrado na Tabela SA2 |
E1_LOJA E2_LOJA | Loja do Cliente Loja do Fornecedor | Caractere | 2 | X | Campos obrigatórios para efetuar o cancelamento dos títulos Loja cadastrada na Tabela SA1 - Clientes Loja cadastrada na Tabela SA2 - Fornecedores |
AUTMOTBX | Motivo da Baixa | Caractere | 3 | x | Conforme Tabela Mot. Baixa Miscelanea/Arquivos/Tabela Mot. Baixa exemplo: |
AUTBANCO | Código do agente cobrador | Caractere | 3 | x | N/A |
AUTAGENCIA | Código da agência do agente cobrador | Caractere | 5 | x | N/A |
AUTCONTA | Número da conta bancária. | Caractere | 10 | x | N/A |
AUTDTBAIXA | Data em que foi/será realizada a baixa. | Caractere | 10 | x | A data deverá ser informada no formato "DD/MM/AAAA". |
AUTDTCREDITO | Data do crédito bancário referente à baixa do título. | Caractere | 10 | x | A data deverá ser informada no formato "DD/MM/AAAA". |
AUTHIST | Histórico da baixa. | Caractere | 40 | x | N/A |
AUTJUROS | Valor do Juros | Numérico | O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 | ||
AUTMULTA | Valor Multa | Numérico | O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 | ||
AUTDESCONT | Valor Desconto | Numérico | O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 | ||
AUTCM1 | Valor Correção monetária | Numérico | O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 | ||
AUTPRORATA | Pro Rata | Numérico | O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 | ||
AUTVALREC | Valor do título receber | Numérico | O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 | ||
AUTVLRPG | Valor do título pagar | Numérico | O valor dos decimais deverá ser separado por "." (ponto). Ex: 1234.56 | ||
| ID | Código de Controle Gesplan | Caractere | x | N/A | |
| SYSCODE | Chave identificadora Gesplan | Caractere | x | N/A | |
| Específico | Campo específico do ERP | Variável | Ver mais detalhes da utilização de campos específicos no "item b" abaixo. |
Ponto de Entrada FiTitGsp para permitir a alteração do conteúdo do execauto do FINA040/FINA050