Páginas filhas
  • Integração Microsiga Protheus e VTEX via LISTOFACCOUNTRECEIVABLEDOCUMENT (EAI) - Integração Financeira

Versões comparadas

Chave

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

Protheus - Guia Cloud TOTVS - TDN   

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
idCenario
effectTypefade
Card
id1
labelPreparação Integração EAI
effectTypefade
Expandir
titleConfiguração EAI

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

Acesse:

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

Card
id1
labelConfigurações
effectTypefade
Expandir
titleParâ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
id1
labelRegras de Validação
effectTypefade

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
id1
labelBreve explicação dos campos
effectTypefade
Expandir
titleCampos Json

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

"DeliveryType":"sync" - Indica se a operação será sincrona ou assincrona

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


Card
id1
labelMensagem JSON
effectTypefade

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