Histórico da Página
...
Campo do XML | Descrição do dado |
---|---|
<TIPO> | Valor default para canais de venda: VENTA |
<FECHA_PEDIDO> | Utilizar a mesma data que consta no pedido do canal de venda, porém no seguinte formato 2021-01-27 12:01:41 |
<NUMERO_PEDIDO_ORIGINAL> | Código do pedido no canal de venda, apresentado na tela de resultado de consulta de pedidos no Omni. |
<NUMERO_PEDIDO_ALTERNATIVO> * | Caso o canal de venda possua um segundo código de pedido (gerado por um hub ou por uma estrutura de lojas dentro do canal) este pode ser armazenado aqui, e também é apresentado na tela de resultado de consulta de pedidos no Omni. Exemplo: |
<ID_ALMACEN_SUMINISTRADOR> * | Id da loja que vai atender o pedido. OBS: Este campo só é utilizado para o caso em que o canal de venda decide qual é a loja para a qual será designada o pedido (VTEX). Em todos os demais casos, não deve ser utilizado este campo. |
<ID_OPERADOR_LOGISTICO> | O ID do operador logístico deve ser definido a partir do nível de serviço logístico selecionado durante a compra pelo cliente. Alguns canais de venda precisam de mapeamento para os níveis de serviço apresentados e o operador logístico. Outros descem a informação (nome ou código) do operador logístico no corpo do pedido. Ainda assim, deve-se criar um parâmetro de credencial para mapear os valores no canal de venda com os códigos de operadores logísticos. Vide TOTVS Omni - Lista de IDs do Omni#ListadeIDsdoOmni-ListadeIDsdeOperadoresLog%C3%ADsticos |
<SERVICE_LEVEL_COD_LOGISTIC> | Código do serviço de entrega que o cliente tem contratado no operador logístico. Este valor será utilizado na criação da entrega no operador logístico (integração via API Operador Logístico pelo Conector). Para alguns casos deve-se criar um parâmetro de credencial para mapear os valores no canal de venda com os códigos de níveis de serviço suportados pelo operador logístico. Vide TOTVS Omni - Lista de IDs do Omni#ListadeIDsdoOmni-ListadeIDsdeOperadoresLog%C3%ADsticos |
<IMPORTE_TOTAL> | Valor total do pedido, sem o custo de entrega. |
<GASTOS_ENVIO> | Custos de envio de acordo com a seleção de serviço de entrega. |
<TIPO_IDENTIFICACION> | Passar o texto CNPJ ou CPF. |
<RAZON_SOCIAL> | Razão social da empresa. No caso de compra realizada com CNPJ. |
<ID_FORMA_PAGO> | Código da forma de pagamento do pedido. Geralmente o valor é mapeado de cada canal para os códigos Omni. Vide TOTVS Omni - Lista de IDs do Omni#ListadeIDsdoOmni-ListadeIDsdeFormasdePagamento Deve-se criar um parâmetro na credencial do canal para mapear estes valores. |
<ID_FORMA_PAGO_TPV> | Informação da forma de pagamento no gateway de pagamento do canal de venda, caso a API do canal disponibize. Para os ERPs trata-se do Adquirente do Cartao de Credito. |
<TPV_REFERENCE> | Geralmente é a marca do cartão de crédito utilizado em caso de pagamento com cartão, caso a API do canal disponibize. |
<IDENTIFICADOR_TRANSACCION> | Identificador da transação financeira operada no canal de venda, caso a API do canal disponibize. |
<TPV_AUTO> | Código de autorização da transação financeira no canal de venda, caso a API do canal disponibize. |
<TARJETA_PAGO> | Dados do cartão de crédito ou débito usado no pagamento do pedido no canal de crédito, caso a API do canal disponibize. |
<PRODUCTOS> <PRODUCTO> <ID_PRODUCTO>995045</ID_PRODUCTO> <ID_SUBPRODUCTO>4101486</ID_SUBPRODUCTO> <IMPORTE>5.00</IMPORTE> <CANTIDAD>1</CANTIDAD> <REFERENCIA>0406210201OMNI-0C5-TNFBR Principal TEST-P</REFERENCIA> <NUMERO_PEDIDO_ORIGINAL>640405</NUMERO_PEDIDO_ORIGINAL> </PRODUCTO> </PRODUCTOS> | Lista dos itens presentes no pedido. Cada item (SKU ou Subproduto) deve estar contido dentro da tag <PRODUCTO>, de acordo com a quantidade vendida daquele SKU (subproduto) e o valor total. <IMPORTE> deve ser o preço da unidade multiplicada pela quantidade. O <ID_PRODUCTO> e o <ID_SUBPRODUCTO> são IDs internos do TOTVS Omni, e devem ser recuperados caso estes não sejam publicados no canal venda com a publicação do produto e recuperado no Pedido. |
<ATRIBUTOS> <ATRIBUTO> <NOMBRE>nsu</NOMBRE> <VALOR>753801563</VALOR> </ATRIBUTO> <ATRIBUTO> <NOMBRE>cuotas</NOMBRE> <VALOR>1</VALOR> </ATRIBUTO> <ATRIBUTO> <NOMBRE>authorization_code</NOMBRE> <VALOR>20242012220300386049</VALOR> </ATRIBUTO> </ATRIBUTOS> | Dados adicionais sobre a operação financeira. Exemplo cuotas é a quantidade de parcelas em que a compra foi feita. Exemplo authorization_code é o código de autorização da operação financeira. |
<DNI_ENVIO>3324734584-1</DNI_ENVIO> | Os dados de envio do pedido, como nome da pessoa receptora e endereço devem ser cadastrados nos campos devidos. OBS: A API do Omni obriga passar Email e Telefone, porém em alguns casos o canal de venda não passa esta informação dentro do pedido. Neste cenário pode-se configurar um valor padrão do conector para passar nestes campos e não deixa-los em branco. OBS: Caso o canal de venda forneça Latitude e longitude pode-se adicionar no XML. |
<DNI>3324734584-1</DNI> <NOMBRE>Mayara</NOMBRE> <APELLIDO_1>Caroline</APELLIDO_1> <VIA>Rua Ricardo Franco</VIA> <NUMERO>91</NUMERO> <COMPLEMENTO>Apto 1</COMPLEMENTO> <COLONIA>Bairro 1</COLONIA> <POBLACION>Sao Paulo</POBLACION> <LOCALIDAD>Sao Paulo</LOCALIDAD> <PROVINCIA>SP</PROVINCIA> <CODIGO_POSTAL>02473130</CODIGO_POSTAL> <TELEFONO_MOVIL>992442314</TELEFONO_MOVIL> <EMAIL>e-mail@.com.bt</EMAIL> <OBSERVACIONES>Mayara Caroline</OBSERVACIONES> | Dados de endereço utilizados para a fatura devem ser criados conforme os campos, mesmo que sejam os mesmos valores de envio. COLONIA = Bairro POBLACION e LOCALIDAD = Cidade PROVINCIA = Estado (Código do estado) OBS: A API do Omni obriga passar Email e Telefone, porém em alguns casos o canal de venda não passa esta informação dentro do pedido. Neste cenário pode-se configurar um valor padrão do conector para passar nestes campos e não deixa-los em branco. |
<FORMAS_DE_PAGO> <FORMA_PAGO> <IMPORTE>25.81</IMPORTE> <ID_FORMA_PAGO>1</ID_FORMA_PAGO> <INSTALLEMENT>1</INSTALLEMENT> <DESCRIPCION>Visa</DESCRIPCION> <NSU/> <FORMA_PAGO_TPV>VISA</FORMA_PAGO_TPV> <OPERADOR>REDE</OPERADOR> <AUTHORIZATION_CODE>317767</AUTHORIZATION_CODE> <INSTALLMENT_INTEREST>1.0</INSTALLMENT_INTEREST> </FORMA_PAGO> </FORMAS_DE_PAGO> | Dados de pagamento utilizados para a fatura que devem ser criadas conforme os campos ao lado, sendo: IMPORTE = Valor pago. ID_FORMA_PAGO = ID da forma de pagamento (vide Lista de IDs do TOTVS Omni). INSTALLEMENT = Quantidade de Parcelas. DESCRIPCION = Bandeira do Cartão de Crédito. FORMA_PAGO_TPV = Operador do Cartão de Crédito. OPERADOR = Operador do Cartão de Crédito. AUTHORIZATION_CODE = Código de autorização do Pagamento. INSTALLMENT_INTEREST = Juros da Parcela. OBS: É possível passar mais de uma forma de pagamento. |
04. TOTVS OMNI CONECTORES
...