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

language	java
title	Body da requisição de inclusão com campo específico
collapse	true

	{
    "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" 
         }
     ]
}

...

Árvore de páginas

Versões comparadas

Versão antiga 26

Nova versão 27

Chave