Histórico da Página
...
Campo | Descrição | Tipo | Tamanho(MAX) | Obrigatório | Observação |
---|---|---|---|---|---|
CompanyId | Código da empresa | 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 |
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 | "I" = Inclusão "E" = Exclusão |
DocumentNumber | 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. |
DocumentPrefix | Prefixo de identificação do título | Caractere | 3 | x | N/A |
DocumentParcel | Parcela do título | Caractere | 1 | x | Pode ser enviado conteúdo vazio. |
DocumentTypeCode | Tipo | Caractere | 3 | x | Conforme tabela SX5 - NF, BOL, FT, etc. |
FinancialNatureID | Natureza financeira | Caractere | 10 | x | N/A |
IssueDate | Emissão do título | Caractere | 10 | x | N/A |
DueDate | Vencimento do título | Caractere | 10 | x | Integração irá calcular o vencimento Real conforme a data informada. |
Currency | Moeda | Numérico | 1 | x | N/A |
CurrencyRate | Taxa da moeda | Numérico | 5 | x | Para moeda 1-Real, indicar taxa 0 |
EntityId | Código do Cliente ou Código de Fornecedor | Caractere | 6 | x | Indicar código válido de cliente ou fornecedor, conforme operação especificada no OperationType |
EntityBranch | Loja do Cliente ou Fornecedor | Caractere | 2 | x | Conforme operação especificada no OperationType |
Value | Valor do título | Numérico | 16 | x | N/A |
History | Histórico | Caractere | 40 | x | Pode ser enviado conteúdo vazio. |
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. |
b. Campo específico/customizado
Existe a possibilidade de enviar qualquer outro campo existente no dicionário de dados da tabela SE1 (Contas a Receber) para OperationType do tipo "R" ou SE2 (Contas a Pagar) para OperationType do tipo "P" do ambiente onde está sendo processada a mensagem.
Esse campo pode ser um campo padrão (não exemplificado na tabela acima) ou um campo customizado (criado especificamente para o ambiente Protheus em que a integração está ativa). Nesse caso, basta que seja inserida uma nova linha no conteúdo da mensagem, com o mesmo formato Chave/Valor, conforme exemplo abaixo, onde inserimos os campos
...
E1_CCUSTO (campo padrão do produto) e E1_XDTCLI (campo específico do ERP do cliente) no movimento com OperationType do tipo "R" e E2_CCUSTO (campo padrão do produto) e
...
E2_XDTCLI (campo específico do ERP do cliente)
...
no movimento com OperationType do tipo "P".
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "specversion": "1.0", "type": "TITreadXGsp", "tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69", "time": "2023-07-19T15:18:08.367574Z", "data": [ { "CompanyId": "T1", "BranchId": "D MG 01", "OperationType" : "R", "OperationAction" : "I", "E1_NUM": "10", "E1_PREFIXO": "GES", "E1_PARCELA": "A", "E1_TIPO": "NF", "E1_NATUREZ": "REC001", "E1_EMISSAO": "19/07/2023", "E1_VENCTO": "20/08/2023", "E1_MOEDA": 1, "E1_TXMOED": 0, "E1_CLIENTE": "000001", "E1_LOJA": "01", "E1_VALOR": 10500.50, "E1_HIST": "CAMPO LIVRE", " "E1_CCUSTO": "CC001", "E1_XDTCLI": "01/07/2023", "ID": "ID001" "SYSCODE": "ID001" }, { "CompanyId": "T1", "BranchId": "D MG 02", "OperationType" : "P", "OperationAction" : "I", "E1_NUM": "20", "E2_PREFIXO": "GES", "E2_PARCELA": "", "E2_TIPO": "NF", "E2_NATUREZ": "PAG001", "E2_EMISSAO": "19/07/2023", "E2_VENCTO": "20/08/2023", "E2_MOEDA": "2", "E2_TXMOED": 4.5, "E2_FORNECE": "000001", "E2_LOJA": "01", "E2_VALOR": 1000, "E2_HIST": "TITULO PAGAR MOEDA 2 - TAXA 4.5", "E2_CCUSTO": "CC001", "E2_XDTCLI": "01/07/2023", "ID": "ID002" "SYSCODE": "ID002" } ] } |
...