Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Aviso
titleAviso

Produto ainda em fase de piloto. 

Fomato de resposta:

CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Dados enviados
    1. Principais Campos e Parâmetros
    2. Moeda do Movimento Bancário
    3. Campo específico/customizado
    4. Entidades Contábeis
  4. Tabelas utilizadas


01. VISÃO GERAL


Modelo a ser seguido para a integração de Movimentos Bancários enviados do sistema Gesplan para o Protheus.

...

O job FwTotvsLinkJob deve ser configurado no schedule, ele é responsável pela leitura das mensagens recebidas na fila do SmartLink.


02. EXEMPLO DE UTILIZAÇÃO

Abaixo temos o modelo de mensagem enviada pela Gesplan.

...

Bloco de código
languagejava
titleExemplo de resposta
collapsetrue
{
	"specversion": "1.0",
	"type": "MOVrespXGsp",
	"tenantId": "c6486a57-3447-461d-bcdf-d66b94226f69",
	"time": "2022-11-08T15:18:08.367574Z",
	"data": [
			{
   		    "CompanyId":"T1" ,
       		"BranchId":  "D MG 01",
            "SYSCODE": "SYSCODE001", 
		 	"ID"	: "ID001"  ,
			"error": "Descrição do erro caso houver"       
			}
			]
}

03. DADOS ENVIADOS

a. Principais Campos e Parâmetros

...

CampoDescriçãoTipoTamanho(MAX)ObrigatórioObservação
CompanyIdCódigo do Grupo de EmpresasCaractere2X

Grupo de Empresa do Protheus.

BranchIdCódigo da FilialCaractere8X

Filial do Protheus.

Identificação da filial do sistema onde ocorrerá o movimento bancário. Em ambientes com Gestão de Empresas o BranchId é composto pela Empresa + Unidade de Negócio + Filial

E5_MOEDANumerário   Caractere2XN/A
E5_VALORValor da movimentação    Numérico16XDecimal deve ser enviado com o caractere ponto
E5_DATAData da Movimentação     Caractere10XData enviada em formato caractere ddmmaaaa ex: "08/09/2022"
E5_VENCTOData de VencimentoCaractere10
Data enviada em formato caractere ddmmaaaa ex: "08/09/2022"
E5_NATUREZNatureza  Caractere10XN/A
E5_BANCOCódigo do banco          Caractere3XN/A
E5_AGENCIAAgencia do banco          Caractere5XN/A
E5_CONTAConta corrente no banco  Caractere10XN/A
E5_RECPAGRecebimento ou Pagamento Caractere1X

Enviar:

"S" → Movimento a pagar (saída)

"E" → Movimento a receber (entrada)

E5_CCUSTOCentro de Custo  Caractere9

N/A

E5_BENEFBeneficiário             Caractere30
N/A
E5_DOCUMENNúmero do DocumentoCaractere50
N/A
E5_HISTORHistórico do movimentoCaractere40
N/A

SYSCODE

Chave identificadora GesplanCaractere
XN/A
IDCódigo de Controle GesplanCaractere
XN/A
EspecíficoCampo específico do ERPVariável

Ver mais detalhes da utilização de campos específicos no "item c" abaixo.

...

CampoDescriçãoTipoTamanho(MAX)ObrigatórioObservação
CompanyIdCódigo do Grupo de EmpresasCaractere2X

Grupo de Empresa do Protheus.

BranchIdCódigo da FilialCaractere8X

Filial do Protheus.

Identificação da filial do sistema onde ocorrerá o movimento bancário. Em ambientes com Gestão de Empresas o BranchId é composto pela Empresa + Unidade de Negócio + Filial

CBCOORIGCódigo do banco origem   Caractere3XN/A
CAGENORIGCódigo da agência origem  Caractere5XN/A
CCTAORIGConta corrente origem   Caractere10XN/A
CNATURORINatureza Origem Caractere10XN/A
CBCODESTCódigo do banco destinoCaractere3XN/A
CAGENDESTCódigo da agência destinoCaractere5XN/A
CCTADESTConta corrente destino Caractere10XN/A
CNATURDESNatureza destino Caractere10X

N/A

CTIPOTRANTipo da TransferênciaCaractere6XN/A
CDOCTRANNúmero do DocumentoCaractere15XN/A
NVALORTRANValor a ser transferido do banco origem para o banco destino.Numérico16XDecimal deve ser enviado com o caractere ponto
CHIST100Histórico da transferênciaCaractere40XHistórico referente a transferência efetuada.
CBENEF100BeneficiárioCaractere30XNome do favorecido para o caso de ser emitido um cheque referente a transferência.
NCTBONLINEContabiliza On Line ?Numérico1
1=Sim;2=Não
DDATACREDData de CréditoCaractere10XData enviada em formato caractere ddmmaaaa ex: "08/09/2022".
E5_RECPAGRecebimento ou Pagamento Caractere1X

Enviar:

"T" → Transferência Bancária (saída)

SYSCODE

Chave identificadora GesplanCaractere
XN/A
IDCódigo de Controle GesplanCaractere
XN/A

...

Card documentos
InformacaoOs campos SysCode e ID não serão gravados no ERP, eles são somente informações de controle da Gesplan, que chegará na requisição e serão enviados na resposta do processamento, indicando sucesso ou falha da inclusão desse Movimento Bancário. Além dos índices de pesquisas disponíveis, é possível listar os registros gerados através do campo origem, com conteúdo FINI100G.
TituloIMPORTANTE!


04. TABELAS UTILIZADAS

  • SE5- Movimentação Bancária (não utilizada explicitamente na integração)
  • FK5- Movimentos Bancários
  • FK8- Dados Contábeis

...