Páginas filhas
  • Manual Operacional da Customização - Integração VTEX Orquestrador DN

Versões comparadas

Chave

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

...

Código de
Informações
iconfalse

Toggle Cloak
Exportação de Contas a Receber

Pedido de Venda
Cloak

O processo de exportação de contas a receber envia os valores pagos no VTEX para API do PROTHEUS (SENAI DN).  Enviando as informações financeiras associadas aos pedidos realizados na plataforma VTEX, que estejam com status: Pronto para manuseio.

O usuário deve utilizar o mesmo processo de exportação de cliente, uma vez que não será possível enviar clientes e contas a receber separadamente.


Neste processo serão enviados os dados da transação, valores e parcelas que compõem o pedido de acordo com a forma de pagamento:

  • Número do Cartão: Quando utilizado os métodos de pagamento CC - Cartão de Crédito ou CD - Cartão de Débito;
  • Código da Autorização: Quando utilizado os métodos de pagamento CC - Cartão de Crédito ou CD - Cartão de Débito;
  • NSU: Quando utilizado os métodos de pagamento CC - Cartão de Crédito ou CD - Cartão de Débito;
  • Nosso Número: Quando utilizado o método de pagamento BOL - Boleto Bancário;
  • Código da Linha Digitável do Boleto Gerado: Quando utilizado o método de pagamento BOL - Boleto Bancário;
  • Código TXID Transação PIX: Quando utilizado o método de pagamento PIX - Pagamento via PIX;
  • Valor: Valor de cada parcela do pedido.


contasReceberdebitoCartão de Débito

Dados utilizados pela integração quando a forma de pagamento é por cartão de débito:

Campo Protheus
Campo
O que envia?Observações
EmpresaEmpresaCódigo da empresa PROTHEUS - Valor fixo 01
FilialFilialCódigo da filial - Valor fixo: 03DN0001
Data_VendaData da Venda do PedidoData da Venda do Pedido
E1_XFORMPGForma de PagamentoCC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEXOrderID VTEXCódigo do pedido no VTEX
E1_CLIENTECódigo do ClienteCódigo do Cliente
E1_LOJALoja do ClienteLoja do Cliente
E1_
PEDIDO
XCLIORICódigo do Seller no ProtheusCódigo cliente DR ou Parceiro - Para DN envia vazio
Pedido de Venda
E1_
CARTAO
XLJORIG
Número
Loja do
Cartão
Seller no ProtheusLoja DR ou Parceiro - Para DN envia vazio
Numero do cartão de crédito ou cartão de débito
E1_
CARTAUT
XCOMIS
Código da Autorização
Valor da Comissão (repasse)Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDOPedido de VendaPedido de Venda
E1_CARTAONúmero do CartãoNumero do cartão de crédito ou cartão de débito
E1_CARTAUTCódigo da AutorizaçãoCódigo de autorização do cartão 
E1_NSUETFNSUNSU do cartão
E1_XVLRDR
E1_XQPARDR
Valor total da Venda SellerValor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDRQuantidade de Parcelas Venda DRQuantidade de Parcelas Venda DR - Caso seja DN envia 0
parcelas (E1_
parcelas (E1_
VALOR)ParcelasValor de cada parcela do pedido
creditoCartão de Crédito

Dados utilizados pela integração quando a forma de pagamento é por cartão de crédito:

Campo Protheus
Campo
O que envia?Observações
EmpresaEmpresaCódigo da empresa PROTHEUS - Valor fixo 01
FilialFilialCódigo da filial - Valor fixo: 03DN0001
Data_VendaData da Venda do PedidoData da Venda do Pedido
E1_XFORMPGForma de PagamentoCC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEXOrderID VTEXCódigo do pedido no VTEX
E1_CLIENTECódigo do ClienteCódigo do Cliente
E1_LOJALoja do ClienteLoja do Cliente
E1_
PEDIDO
XCLIORICódigo do Seller no ProtheusCódigo cliente DR ou Parceiro - Para DN envia vazio
E1_XLJORIGLoja do Seller no ProtheusLoja DR ou Parceiro - Para DN envia vazio
E1_XCOMISValor da Comissão (repasse)Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDOPedido de VendaPedido de Venda
E1_
Pedido de VendaPedido de VendaE1_
CARTAONúmero do CartãoNumero do cartão de crédito ou cartão de débito
E1_XVLRDR
E1_XQPARDR
Valor total da Venda SellerValor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDRQuantidade de Parcelas Venda DRQuantidade de Parcelas Venda DR - Caso seja DN envia 0
parcelas (E1_VALOR)ParcelasValor de cada parcela do pedido
boletoBoleto

Dados utilizados pela integração quando a forma de pagamento é por boleto:

Campo Protheus
Campo
O que envia?Observações
EmpresaEmpresaCódigo da empresa PROTHEUS - Valor fixo 01
FilialFilialCódigo da filial - Valor fixo: 03DN0001
Data_VendaData da Venda do PedidoData da Venda do Pedido
E1_XFORMPGForma de PagamentoCC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEXOrderID VTEXCódigo do pedido no VTEX
E1_CLIENTECódigo do ClienteCódigo do Cliente
E1_LOJALoja do ClienteLoja do Cliente
E1_
PEDIDOPedido de VendaPedido de VendaE1_XIDTRANE1_XVLRDRE1_XQPARDRparcelas (E1_VALOR)ParcelasValor de cada parcela do pedido
XCLIORICódigo do Seller no ProtheusCódigo cliente DR ou Parceiro - Para DN envia vazio
E1_XLJORIGLoja do Seller no ProtheusLoja DR ou Parceiro - Para DN envia vazio
E1_XCOMISValor da Comissão (repasse)Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDOPedido de VendaPedido de Venda
E1_XIDTRANCódigo da TransaçãoCódigo da Transação
E1_NUMBCO Nosso Número BoletoNosso Número Boleto
E1_LINDIGCódigo da Linha Digitável do Boleto GeradoCódigo da Linha Digitável do Boleto Gerado
E1_XVLRDRValor total da Venda SellerValor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDRQuantidade de Parcelas Venda DRQuantidade de Parcelas Venda DR - Caso seja DN envia 0
parcelas (E1_VALOR)ParcelasValor de cada parcela do pedido
pixPix

Dados utilizados pela integração quando a forma de pagamento é por PIX:

Campo ProtheusO que envia?Observações
EmpresaEmpresaCódigo da empresa PROTHEUS - Valor fixo 01
FilialFilialCódigo da filial - Valor fixo: 03DN0001
Data_VendaData da Venda do PedidoData da Venda do Pedido
E1_XFORMPGForma de PagamentoCC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEXOrderID VTEXCódigo do pedido no VTEX
E1_CLIENTECódigo do ClienteCódigo do Cliente
E1_LOJALoja do ClienteLoja do Cliente
E1_XCLIORICódigo do Seller no ProtheusCódigo cliente DR ou Parceiro - Para DN envia vazio
E1_XLJORIGLoja do Seller no ProtheusLoja DR ou Parceiro - Para DN envia vazio
E1_XCOMISValor da Comissão (repasse)Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDOPedido de VendaPedido de Venda
E1_XIDTRANCódigo da TransaçãoCódigo da Transação
E1_XTXIDCódigo TXID Transação PIXCódigo TXID Transação PIX
E1_XDTHRPXData VendaData Hora do Pix
E1_XVLRDRValor total da Venda SellerValor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDRQuantidade de Parcelas Venda DRQuantidade de Parcelas Venda DR - Caso seja DN envia 0
pixPix

Dados utilizados pela integração quando a forma de pagamento é por PIX:

Campo ProtheusCampoObservaçõesEmpresaEmpresaCódigo da empresa PROTHEUS - Valor fixo 01FilialFilialCódigo da filial - Valor fixo: 03DN0001Data_VendaData da Venda do PedidoData da Venda do PedidoE1_XFORMPGForma de PagamentoCC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIXE1_XIDVTEXOrderID VTEXCódigo do pedido no VTEXE1_CLIENTECódigo do ClienteCódigo do ClienteE1_LOJALoja do ClienteLoja do ClienteE1_PEDIDOPedido de VendaPedido de VendaE1_XIDTRANE1_XDTHRPXE1_XVLRDRE1_XQPARDR
parcelas (E1_VALOR)ParcelasValor de cada parcela do pedido
Informações
iconfalse

Toggle Cloak
Exportação de Contas a Receber Seller

Cloak

A identificação de um cliente Seller (Pessoa jurídica) é realizada a partir da verificação do campo: Nome do Seller no cadastro do Item do pedido no Monitor de Vendas, conforme citado anteriormente.

GreenExemplo

Pedido Id: 122550
Valor Total do Pedido: R$ 300,00
Itens do Pedido:

  • Curso A: Valor R$ 100,00 - Seller: SENAI Bahia - Comissão*: R$ 10,00
  • Curso B: Valor R$ 100,00 - Loja Principal DN
  • Curso C: Valor R$ 100,00 - Seller: SENAI Bahia - Comissão: R$ 10,00

Verificados os itens do pedido, serão enviadas ao PROTHEUS duas contas a receber, conforme:

  • Conta a receber 01: Com ao cliente SENAI Bahia - Valor R$ 20,00
  • Conta a receber 02: Com cliente que realizou a compra na Loja Principal DN - Valor R$ 100,00


 Yellow*Comissão

O cálculo do valor correspondente a comissão a partir das vendas/pedidos de clientes do tipo Seller, é realizado considerando:
Valor do percentual da comissão x o Valor do Item .

Este será o valor enviado apenas para itens vendidos por Seller, dividido pelo número de parcelas. Caso o pagamento tenha sido parcelado, os valores serão enviados divididos pelo número de parcelas do pagamento do Pedido.

 

Pedido Id: 122552
Valor: R$ 100,00
Comissão: 10%
Itens do Pedido:

  • Curso A: Valor R$ 100,00

Total Comissão Seller SENAI Bahia: R$ 10,00
Pedido Id: 122552
Valor: R$ 300,00
Parcelamento: 02 Parcelas
Itens do Pedido:

  • Curso A: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia
  • Curso B: Valor R$ 100,00 - Loja Principal DN
  • Curso C: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia

Verificados os itens do pedido dividido em 2X, serão enviadas ao PROTHEUS duas contas a receber, conforme:

  • Conta a receber 01: Correspondente ao cliente SENAI Bahia - Valor R$ 20,00

02 parcelas de R$10,00 (cada).

  • Conta a receber 02: Correspondente ao cliente Loja Principal DN - Valor R$ 100,00

02 parcelas de R$50,00 (cada).

Pagamentos por PIX ou Boleto

Durante o processo de envio de Contas a receber, quando identificado que um pedido é da modalidade de pagamento pix ou boleto,  a customização consultará o valor do repasse do Monitor de Vendas. Não será realizada a soma do repasse de cada item

...