Modelo de dados a ser seguido para a integração de movimentos em Conta Corrente do Caixa e Bancos Datasul.
Envio de dados deve ser realizado via Smart Link utilizando o Padrão CloudEvents/Modo Estruturado para envio de mensagens no formato Json de acordo com o modelo a seguir :
{
"messageId": "123",
"audience:": "CMG",
"messageType": "CMGCheckingAccountMovement",
"additionalInfo": "",
"messageContent": {
"specVersion": "1.0",
"user": "UserCodeDatasul",
"company": "CompanyCodeDatasul",
"productCode": "GFN",
"idExternal": "123456",
"movements": [
{
"checkingAccount": "341001",
"movementDate": "2024-10-15",
"value": "100",
"transctionType": "TRANSF",
"flowIndicatorMovement": "ENT",
"movementType": "RE",
"bankDocumentCode": "87953361",
"historyCode": "Pagamento",
"complementaryHistory": "Transferência referente Pagamento xpto",
"checkingAccountTransfer": "341002",
"keyCode": "000000001"
},
{
"checkingAccount": "341001",
"movementDate": "2024-10-15",
"value": "250",
"transctionType": "DESP",
"flowIndicatorMovement": "SAI",
"movementType": "RE",
"bankDocumentCode": "900557484",
"historyCode": "Despesa",
"complementaryHistory": "Despesa Bancária referente a transação xpto",
"checkingAccountTransfer": "",
"keyCode": "000000002"
}
]
}
} |
A propriedade 'movements' deverá ser enviada no formato array, onde cada item desse array deverá conter os dados do movimento ser lançado na Conta Corrente no Caixa e Bancos Datasul. Cada linha deverá conter ao menos uma conta corrente para receber o lançamento, podendo ser até duas contas informadas ("checkingAccount" e "checkingAccountTransfer") quando for realizado movimentação de Transferência Bancária. |
{
"parentUUID": "00000001",
"audience:": "CMG",
"messageType": "CMGCheckingAccountMovementResponse",
"additionalInfo": "",
"messageContent": [
{
"idExternal": "123456",
"keyCode": "000000001",
"sequenceNumber": "10",
"checkingAccount": "",
"movementDate": "",
"movementSequence": "",
"error": [
{
"code": "21474",
"description": "Tipo de Transação de Caixa TRANSF inexistente!",
"help": "O Tipo de transação de Caixa TRANSF informado nos Parâmetros de Controle do Caixa é Inexistente!"
}
]
},
{
"idExternal": "123456",
"keyCode": "000000002",
"sequenceNumber": "10",
"checkingAccount": "341001",
"movementDate": "2024-10-15",
"movementSequence": "2",
"error": [
{
"code": "1",
"description": "Processamento efetuado com sucesso.",
"help": "O Movimento foi processado com sucesso no Caixa e Bancos Datasul."
}
]
}
]
} |
Principais Campos e Parâmetros
Dados Cabeçalho Movimentos da Conta Corrente
| Campo | Descrição | Tipo | Tamanho | Obrigatório | Observação |
|---|---|---|---|---|---|
| specVersion | Versão da Mensagem | Caractere | 3 | X | Hoje a versão disponível é apenas 1.0 |
| user | Código do usuário | Caractere | 12 | Código do usuário cadastrado no produto Datasul | |
| company | Código da empresa | Caractere | 3 | X | Código da empresa |
| productCode | Código Módulo/Produto Origem | Caractere | 3 | X | Código Módulo/Produto de Origem cadastrado no Datasul |
| idExternal | ID Externo do Registro | Caractere | 10 | Esta informação identifica a processo /rotina/programa de origem, e será retornado após processamento via Mensagem Resposta |
Movimentação Conta Corrente (propriedade: Movements)
| Campo | Descrição | Tipo | Tamanho | Obrigatório | Observação |
|---|---|---|---|---|---|
| debitAccountCode | Conta contábil débito | Caractere | 20 | X | Conta contábil |
| creditAccountCode | Conta contábil crédito | Caractere | 20 | X | Conta contábil |
| costCenterCode | Centro de Custo Débito | Caractere | 11 | Centro de Custo | |
| costCenterCreditCode | Centro de Custo Crédito | Caractere | 11 | Centro de Custo | |
| entryValue | Valor do Lançamento | Numérico | 18 | X | decimal deve ser enviado com o caractere ponto |
| historyCode | Código do Histórico | Caractere | 8 | Histórico Padrão | |
| complementaryHistory | Complemento do Histórico Contábil | Caractere | 2000 | X | Complemento da descrição do histórico |
| businessUnitDebitCode | Unidade de Negócio Débito | Caractere | 3 | Unid Negócio | |
| businessUnitCreditCode | Unidade de Negócio Crédito | Caractere | 3 | Unid Negócio | |
| movementDate | Data do Lançamento | Caractere | 10 | X | Data enviada em formato caractere aaaammdd ex: "2024-10-16" |
| branchId | Estabelecimento | Caractere | 5 | X | Estabelecimento |
| currencyCode | Moeda | Caractere | 8 | X | Indicador econômico do lançamento, por exemplo: 'Real'. |
| keyCode | Chave identificadora | Caractere | 200 | X | SYSCODE (GESPLAN) |
OBS: Para cada integração será gerado a capa de lote contendo 1 ou mais itens de lançamento.
Principais Campos e Parâmetros
| Campo | Descrição |
|---|---|
| Inclua o campo | Inclua a descrição relacionada |
| Inclua o campo | Inclua a descrição relacionada |
| Inclua o campo | Inclua a descrição relacionada |
Coloque o link das tabelas relacionadas