Histórico da Página

1. VISÃO GERAL

Implementada a funcionalidade de Integração BackOffice do sistema Microsiga Protheus® (Importante: para release 12.1.25 ou superior) com o sistema E-Commerce da VTEX®, possibilitando a troca de informações e processos detalhados abaixo.

Os dados são enviados/recebidos por meio da mensagem padronizada TOTVS com a funcionalidade EAI (Enterprise Application Integration), disponível no módulo Configurador.

Nesse modelo as integrações serão direcionadas diretamente à rotina FINA040 (Títulos a Receber).

2. DETALHAMENTO

Deck of Cards

id	Cenario
effectType	fade

Card

id	1
label	Preparação Integração EAI
effectType	fade

Expandir

title	Configuração EAI

Para maiores informações de como configurar a integração,

Acesse:

Integração Protheus x VTEX - Via Mensagem Padronizada (EAI)

Card

id	1
label	Configurações
effectType	fade

Expandir

title	Parâmetros Necessários

MV_LJGERTX : SIGALOJA 0013 Finalidade do parâmetro MV_LJGERTX - Linha Microsiga Protheus - TDN (totvs.com)

Quando o parâmetro MV_LJGERTX estiver configurado com conteúdo igual a .T., o valor das taxas cobradas pelas Administradoras Financeiras é discriminado nos títulos do Contas a Pagar, e o valor bruto da venda (valor líquido somado à taxa da administradora), é exibido nos títulos gerados em Contas a Receber.

Se for igual a .F. o valor da taxa, será descontado do titulo a receber.

Configurar os parâmetros relacionados as naturezas, conforme link: SIGALOJA 0320 Quais são os parâmetros que definem os tipos de Naturezas?

MV_NATVALE;

MV_NATCART;

MV_NATTEF;

MV_NATCONV;

MV_LJNATFI;

MV_NATFIN;

MV_NATPGDG;

MV_NATOUTR;

MV_NATPGPX

Card

id	1
label	Regras de Validação
effectType	fade

Regras de validação:

Caso o "PaymentMethodCode" for diferente de cartão de crédito, não é necessário enviar o "PaymentDetail":

Se não for enviado o DocumentCode, o sistema irá gerar com a próxima numeração da SE1

Se for enviado o DocumentCode, o FinanceNature também passa a ser obrigatório ser enviado

Para pagamentos via boleto bancário, as TAG´s ProductName e PaymentMethodCode deverão ser enviadas:

"PaymentMethodCode": "BOL",

Caso as tags abaixo sejam enviadas em conjunto do tipo Boleto, os títulos serão baixados automaticamente:

  "BankCode": "237",
                "AgencyCode": "00000",
                "AccountCode": "0000000000",

Card

id	1
label	Breve explicação dos campos
effectType	fade

Expandir

title	Campos Json

Header:

"Transaction": "LISTOFACCOUNTRECEIVABLEDOCUMENT", → Campo necessário para o correto direcionamento ao adapter EAI

"DeliveryType":"sync" → Indica se a operação será síncrona ou assíncrona

"UUID":"000000000000000860", → Identificado único da comunicação (Presente na tabela XX3, campo XX3_UUID)

Documents:

"Prefix": "LF3" → Prefixo do título (E1_PREFIXO)

"Prefix":"LF3", → Prefixo do título (E1_PREFIXO)

"DocumentCode": "000000001" → Número do Título E1_NUM. Caso não for preenchido o sistema irá buscar uma próxima numeração considerando Prefixo(E1_PREFIXO) e Tipo(E1_TIPO).

"CustomerCode": "LF0001" → Cód. Cliente (A1_COD/E1_CLIENTE)

"CustomerStore": "00" → Loja Cliente (A1_LOJA/E1_LOJA)

"CustomerVendorInternalId": "" → Id do Cliente na aplicação de origem. Caso não forem preenchidos CustomerCode e CustomerStore, o sistema irá consultar o CustomerVendorInternalId no cadastro de De/Para de Mensagem Única (tabela XXF)

"PaymentMethodCode": "CC" → Tipo do título (E1_TIPO)

"FinanceNature": "LF007" → Natureza do título (E1_NATUREZ)

"IssueDate": "29/06/2021", → Data Emissão

"RealDate": "29/06/2021", → Data Vencimento

"Observation": "OBSERVACAO" → Histórico (E1_HIST)

"ECommerceOrder": "000011" → Identificação na aplicação origem

"CurrencyCode": "1" → Moeda do título E1_MOEDA

"TotalPrice": 200 → Valor do título (E1_VALOR)

"BankCode": "237", → Banco (A6_COD)

"AgencyCode": "00001", → Agência (A6_AGENCIA)

AccountCode": "0000000001" → Conta (A6_NUMCON)

PaymentDetail:

"UniqueSerialNumber": "123456" → NSU SITEF (E1_NSUTEF) - Identificador da transação TEF - Cartão de Crédito

"DateOfPayment": "2020-11-26T00:00:00" → Data Pagamento

"FinancialManagerCode": "001" → Código da administradora Financeira (AE_COD)

"PaymentValue": 100 → Valor Total do Pagamento

"Parcel": "2" → Quantidade de Parcelas do Pagamento

Card

id	1
label	Mensagem JSON
effectType	fade

{
    "Header": {
        "Version": "1.000",
        "CompanyId": "T1",
        "BranchId": "D MG 01",
        "BusinessUnit": "MG ",
        "GeneratedOn": "2021-06-09T11:53:47Z",
        "Enterprise": "T1",
        "ProductVersion": "12",
        "SourceApplication": "VTEX",
        "ProductName": "VTEX",
        "Transaction": "LISTOFACCOUNTRECEIVABLEDOCUMENT",
        "StandardVersion": "1.000",
        "UUID": "000000000000000860",
        "SubType": "event",
        "Type": "BusinessMessage",
        "DeliveryType": "async"
    },
    "Content": {
        "Event": "upsert",
        "Documents": [
            {
                "Prefix": "001",
                "DocumentCode": "000001",
                "CustomerVendorInternalId": "",
                "ECommerceOrder": "000001",
                "TotalPrice": 200.00,
                "CurrencyCode": "1",
                "CustomerCode": "000001",
                "CustomerStore": "01",
                "FinanceNature": "999999",
                "IssueDate": "24/06/2021",
                "RealDate": "24/06/2021",
                "Observation": "OBSERVACAO",
                "PaymentMethodCode": "CC",
                "BankCode": "237",
                "AgencyCode": "00000",
                "AccountCode": "0000000000",
                "PaymentDetail": [
                    {
                        "FinancialManagerCode": "001",
                        "UniqueSerialNumber": "123456",
                        "DateOfPayment": "2020-11-26T00:00:00",
                        "PaymentValue": 100,
                        "Parcel": "2"
                    }
                ]
            }
        ]
    }
}

HTML

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

Páginas filhas

Versões comparadas

Versão antiga 33

Nova versão 34

Chave