Mudanças entre as edições de "Configuração da unit APIECOMMERCES CONFIGURACAO"

De Tek-System Wiki
Ir para navegação Ir para pesquisar
 
(10 revisões intermediárias por 4 usuários não estão sendo mostradas)
Linha 4: Linha 4:


'''Token''': Solicite ao setor desenvolvimento a geração do token
'''Token''': Solicite ao setor desenvolvimento a geração do token
'''TransacaoVenda''': Código da transação de venda. Caso não seja informada, usará a transação padrão do parâmetro do sistema


'''VendaOrdem''': Determina se a integração é venda à ordem
'''VendaOrdem''': Determina se a integração é venda à ordem
'''VendaSemIntermediador''': Determina se obrigará a integração a informar o intermediador da operação. Usado normalmente para ecommerces sem integração com marketplaces.


'''VendaOrdem_canal_EmiteNF''': Determina se a integração é venda à ordem onde o canal de integração irá emitir as notas fiscais de venda ao consumidor em razão da empresa
'''VendaOrdem_canal_EmiteNF''': Determina se a integração é venda à ordem onde o canal de integração irá emitir as notas fiscais de venda ao consumidor em razão da empresa
Linha 27: Linha 31:
'''EmpresasParaEnvioEstoque''': Código das empresas para montagem do estoque. Separe por vírgula caso considere mais de uma
'''EmpresasParaEnvioEstoque''': Código das empresas para montagem do estoque. Separe por vírgula caso considere mais de uma


'''Integracao_DesconsiderarSaldoVolumeCompartilhado''': Ignora volume compartilhado na montagem de saldo do produto, ou seja, monta toda quantidade disponível para todos os produtos que fazem uso do mesmo volume. Campo booleano (valor default false)
'''AlmoxarifadoParaEnvioEstoque''': Código dos almoxarifados para montagem do estoque. Separe por vírgula caso considere mais de um almoxarifado.


'''EmpresasDocAbatEstoque''': Código das empresas para Abatimento de documentos na montagem do estoque. Separe por vírgula caso considere mais de uma
'''EmpresasDocAbatEstoque''': Código das empresas para Abatimento de documentos na montagem do estoque. Separe por vírgula caso considere mais de uma
Linha 38: Linha 42:
'''CodStatusInativo''': Código dos status inativo para o não envio do produto. Caso tenha mais de 1, separe por vírgula
'''CodStatusInativo''': Código dos status inativo para o não envio do produto. Caso tenha mais de 1, separe por vírgula


'''CodStatusEmProducao''': Código do status a ser considerado para envio do status de em produção para o ecommerce/marketplace.
'''CodStatusEmProducao''': Código do status a ser considerado para envio do status de em produção para o ecommerce/marketplace. '''(Utilizado apenas para o canal XCOMMERCE).'''


'''CodStatusDetalhamentoNaoEnviadoParaEcommerce''': Código dos status inativo para o não envio do detalhamento do produto. Permite apenas 1 status
'''CodStatusDetalhamentoNaoEnviadoParaEcommerce''': Código dos status inativo para o não envio do detalhamento do produto. Permite apenas 1 status
Linha 44: Linha 48:
'''AbaterAoSaldoFisico''': Código da opção Abater ao Saldo Físico do Relatório de Montagem x Sobras. A sequência começa em zero
'''AbaterAoSaldoFisico''': Código da opção Abater ao Saldo Físico do Relatório de Montagem x Sobras. A sequência começa em zero


'''CodTabPrecos''': Código da tabela de preço para envio e atualização do produto
'''CustoPelaTabelaPreco''': Tipo boolean(true/false). Determina se o valor unitário deve ser atribuído pela tabela de preço. Se informar false, será mantido o valor importado
 
'''CodTabPrecos''': Código da tabela de preço para envio e atualização do produto e importação de pedido
 
'''CodCondicaoPrecoDe''': Código da condição de pagamento do preço de venda sem desconto


'''CodCondicaoPrecoVenda''': Código da condição de pagamento do preço de venda com desconto
'''CodCondicaoPrecoVenda''': Código da condição de pagamento do preço de venda com desconto


'''CodCondicaoPrecoDe''': Código da condição de pagamento do preço de venda sem desconto
'''CodCondicaoPrecoVendaPorLoja''': Array com a configuração do preço de venda por Loja. Além do "Preço De" e "Preço Por", cada loja será uma condição de pagamento da tabela. '''(Utilizado apenas para o canal PRECODE).'''
 
Será necessário configurar "loja" e "nomeLojaPedido" pois, apesar de ser a mesma loja, para enviar os preços utiliza-se um nome, mas para carregar o pedido, vem com outro nome.
 
'''CodTabPrecoAssistencia''': Código da tabela de preço para importação de assistência técnica. Se não informada, usará a do atributo "CodTabPrecos"


'''CustoPelaTabelaPreco''': Tipo boolean(true/false). Determina se o valor unitário deve ser atribuído pela tabela de preço. Se informar false, será mantido o valor importado
'''CodCondPagtoAssistencia''': Código da condição de pagamento com preço para tabela de assistência técnica. Se não informada, usará a do atributo "CodCondicaoPrecoVenda"


'''ModalidadeFrete''': Código da modalidade de frete para importação do documento. Consulte a modalidade de frete no documento para ver as opções. A sequência começa em zero
'''ModalidadeFrete''': Código da modalidade de frete para importação do documento. Consulte a modalidade de frete no documento para ver as opções. A sequência começa em zero
Linha 59: Linha 71:


'''EmailsNotificacoes''': E-mail(s) para receber notificações de erros na execução dos processos. Separe por ; caso tenha vários e-mails
'''EmailsNotificacoes''': E-mail(s) para receber notificações de erros na execução dos processos. Separe por ; caso tenha vários e-mails
'''PerfilParaNotificacoes''': Código do Perfil de Acesso para notificar usuários nas integrações. Se utilizado, será desconsiderado as tags de <b>UsuariosNotificacoes</b> e <b>EmailsNotificacoes</b>


'''UtilizaPrazosDaCondicaoPagamentoTabelaPreco''': Determina se utilizada os prazos da condição de pagamento da propriedade '''CodCondicaoPrecoVenda''' ou manterá a do documento origem. Opção não deve ser habilitada para venda à ordem, pois já irá ser atribuído o padrão definido no cadastro do cliente. Campo booleano(true/false).  
'''UtilizaPrazosDaCondicaoPagamentoTabelaPreco''': Determina se utilizada os prazos da condição de pagamento da propriedade '''CodCondicaoPrecoVenda''' ou manterá a do documento origem. Opção não deve ser habilitada para venda à ordem, pois já irá ser atribuído o padrão definido no cadastro do cliente. Campo booleano(true/false).  
Linha 106: Linha 120:


'''VendaOrdem''': Habilitar está propriedade. Informe true
'''VendaOrdem''': Habilitar está propriedade. Informe true
'''empresaEntregaParaConsumidorFinal''': Define se a empresa faz a entrega direto para o consumidor final. Na integração, quando o consumidor final não busca na loja, o campo "Entrega Mercadoria" vem marcado.


'''CodTransacaoRemessaSimbolicaVenda''': Código da transação de venda para remessa simbólica
'''CodTransacaoRemessaSimbolicaVenda''': Código da transação de venda para remessa simbólica
Linha 153: Linha 169:
     "CodStatusDetalhamentoNaoEnviadoParaEcommerce":39,
     "CodStatusDetalhamentoNaoEnviadoParaEcommerce":39,
     "AbaterAoSaldoFisico":0,
     "AbaterAoSaldoFisico":0,
    "TransacaoVenda": 1,
     "CodTabPrecos":365,
     "CodTabPrecos":365,
     "CodCondicaoPrecoVenda":23,
     "CodCondicaoPrecoVenda":23,
Linha 179: Linha 196:
             "IdentificacaoCanalIntermediario": "USUARIO CANAL".
             "IdentificacaoCanalIntermediario": "USUARIO CANAL".
             "CodigoFamiliaItem": 0
             "CodigoFamiliaItem": 0
        },
        {
            "canal":"PRECODE",
            "CodOrgao":17,
            "CodTagCompartilhaSaldoItem":4,
            "CodTabPrecos":16,
            "CodCondicaoPrecoDe": 7,
            "CodCondicaoPrecoVenda":8,
            "CodCondicaoPrecoVendaPorLoja": [
                {
                    "loja": "Magalu",
                    "CodCondicaoPrecoVenda":9,
                    "nomeLojaPedido": "Magazine Luiza"
                },
                {
                  "loja": "B2W",
                    "CodCondicaoPrecoVenda": 10,
                    "nomeLojaPedido": "B2W 2"
                },
                {
                    "loja": "Leroy",
                    "CodCondicaoPrecoVenda":11,
                    "nomeLojaPedido": "Leroy Merlin"
                }
            ]
         },
         },
         {   
         {   

Edição atual tal como às 20h01min de 8 de novembro de 2024

Descrição da funcionalidade de cada propriedade disponível na configuração

URL: Informar https://ecommerces.teksystem.com.br:8090/api/v1/

Token: Solicite ao setor desenvolvimento a geração do token

TransacaoVenda: Código da transação de venda. Caso não seja informada, usará a transação padrão do parâmetro do sistema

VendaOrdem: Determina se a integração é venda à ordem

VendaSemIntermediador: Determina se obrigará a integração a informar o intermediador da operação. Usado normalmente para ecommerces sem integração com marketplaces.

VendaOrdem_canal_EmiteNF: Determina se a integração é venda à ordem onde o canal de integração irá emitir as notas fiscais de venda ao consumidor em razão da empresa

CodTagMarcaProduto: Código da tag característica para marca do produto. A tag deve ser do tipo String

CodTagCompartilhaSaldoItem: Código da tag característica para envio do produto ao marketplace. A tag deve ser do tipo Lógico

CodTagOrdemDeMontagemItem: Código da tag característica para definir a ordem de montagem do estoque. A tag deve ser do tipo Inteiro

CodTagQtdeMaximaAMontar: Código da tag característica para definir a quantidade de estoque a ser montada. A tag deve ser do tipo Inteiro

CodTagQtdeReservadoAEmpresa: Código da tag característica para definir a quantidade de estoque reservada a empresa. A tag deve ser do tipo Inteiro

AcrescentarSaldoElaboracaoAoSaldoFisico: Determina se deve ser somado saldo em elaboração ao saldo físico de volumes para montagem de saldo de produtos. Valores (true ou false)

CodigoOutCampoQtdMaximaDetalhe: Código de outro campo extra para o cadastro Item Detalhe para definir a quantidade máxima a montar de estoque por detalhamento do produto. Deve ser do tipo Inteiro

CodTagVendaSemEstoque: Código da tag característica para definir se há venda sem estoque do produto. A tag deve ser do tipo Lógico

EmpresasParaEnvioEstoque: Código das empresas para montagem do estoque. Separe por vírgula caso considere mais de uma

AlmoxarifadoParaEnvioEstoque: Código dos almoxarifados para montagem do estoque. Separe por vírgula caso considere mais de um almoxarifado.

EmpresasDocAbatEstoque: Código das empresas para Abatimento de documentos na montagem do estoque. Separe por vírgula caso considere mais de uma

CodTagTempoEntregaSemEstoque: Código da tag característica para definir o tempo de entrega do produto sem estoque. A tag deve ser do tipo Inteiro

CodTagTempoEntregaComEstoque: Código da tag característica para definir o tempo de entrega do produto com estoque. A tag deve ser do tipo Inteiro

 As propriedades CodTagTempoEntregaSemEstoque e CodTagTempoEntregaComEstoque são utilizados nos canais EZCOMMERCE, ANYMARKET e ALTERNATIVASISTEMAS

CodStatusInativo: Código dos status inativo para o não envio do produto. Caso tenha mais de 1, separe por vírgula

CodStatusEmProducao: Código do status a ser considerado para envio do status de em produção para o ecommerce/marketplace. (Utilizado apenas para o canal XCOMMERCE).

CodStatusDetalhamentoNaoEnviadoParaEcommerce: Código dos status inativo para o não envio do detalhamento do produto. Permite apenas 1 status

AbaterAoSaldoFisico: Código da opção Abater ao Saldo Físico do Relatório de Montagem x Sobras. A sequência começa em zero

CustoPelaTabelaPreco: Tipo boolean(true/false). Determina se o valor unitário deve ser atribuído pela tabela de preço. Se informar false, será mantido o valor importado

CodTabPrecos: Código da tabela de preço para envio e atualização do produto e importação de pedido

CodCondicaoPrecoDe: Código da condição de pagamento do preço de venda sem desconto

CodCondicaoPrecoVenda: Código da condição de pagamento do preço de venda com desconto

CodCondicaoPrecoVendaPorLoja: Array com a configuração do preço de venda por Loja. Além do "Preço De" e "Preço Por", cada loja será uma condição de pagamento da tabela. (Utilizado apenas para o canal PRECODE).

Será necessário configurar "loja" e "nomeLojaPedido" pois, apesar de ser a mesma loja, para enviar os preços utiliza-se um nome, mas para carregar o pedido, vem com outro nome.

CodTabPrecoAssistencia: Código da tabela de preço para importação de assistência técnica. Se não informada, usará a do atributo "CodTabPrecos"

CodCondPagtoAssistencia: Código da condição de pagamento com preço para tabela de assistência técnica. Se não informada, usará a do atributo "CodCondicaoPrecoVenda"

ModalidadeFrete: Código da modalidade de frete para importação do documento. Consulte a modalidade de frete no documento para ver as opções. A sequência começa em zero

CanaisDisponiveis: lista de canais na qual a empresa integra. Ex: ["TRAYCORP", "MARABRAZ"]

UsuariosNotificacoes: Nome do usuário do sistema para receber notificações de erros na execução dos processos

EmailsNotificacoes: E-mail(s) para receber notificações de erros na execução dos processos. Separe por ; caso tenha vários e-mails

PerfilParaNotificacoes: Código do Perfil de Acesso para notificar usuários nas integrações. Se utilizado, será desconsiderado as tags de UsuariosNotificacoes e EmailsNotificacoes

UtilizaPrazosDaCondicaoPagamentoTabelaPreco: Determina se utilizada os prazos da condição de pagamento da propriedade CodCondicaoPrecoVenda ou manterá a do documento origem. Opção não deve ser habilitada para venda à ordem, pois já irá ser atribuído o padrão definido no cadastro do cliente. Campo booleano(true/false).

CalcularPrevisaoImpostos: Campo booleano(true/false). Habilitar apenas se a empresa possui IPI. Serve para abater o valor do IPI no pedido para que o total da nota fiscal seja o mesmo valor pago pelo consumidor final

CodTributacaoEspecialNaoContribuinte: Código da tributação especial para não contribuinte

CodTributacaoEspecialContribuinte: Código da tributação especial para contribuinte

 As propriedades CodTributacaoEspecialNaoContribuinte e CodTributacaoEspecialContribuinte quando não definidas, será adotado as tributações especiais padrões

CodMotivoPadraoAssistencia: Código padrão do motivo da assistência

CodOutCampoPagamento: Código do cadastro de outros campos para armazenar informações sobre os dados de pagamento do pedido.

NaoCadastrarAtualizarCliente: Utilizado quando não será feito o cadastro do cliente através da importação, onde este já está previamente cadastrado no sistema. Valores (true ou false)

GravarEnderecoEntregaObservacaoNF: Utilizado para atribuir na observação da nota fiscal o endereço de entrega. Valor padrão false. Aceita (true ou false)

CodigoFamiliaItem: Código da família do item. Utilizado para atribuir ao item do pedido o código da família. Apenas será atribuído quando o produto anunciado no site for um item de família. Importante, está configuração deve ser feita por canal de venda.


Configuracoes_por_empresa: Configurações específicas por canal de empresa

 Exe:
  "Configuracoes_por_empresa":[
    {
       "empresa":1, 
       "CodTabPrecos":0,
       ... Você pode adicionar qualquer uma das propriedades acima
    }
  ]

Configuracoes_por_canal: Configurações específicas por canal de venda

 Exe:
  "Configuracoes_por_canal":[
    {  
           "canal":"INTEGRACOMMERCE",
           "CodOrgao": 30,
           ... Você pode adicionar qualquer uma das propriedades acima
    }             
  ]


Configurações por canal para Venda à Ordem

VendaOrdem: Habilitar está propriedade. Informe true

empresaEntregaParaConsumidorFinal: Define se a empresa faz a entrega direto para o consumidor final. Na integração, quando o consumidor final não busca na loja, o campo "Entrega Mercadoria" vem marcado.

CodTransacaoRemessaSimbolicaVenda: Código da transação de venda para remessa simbólica

CodTransacaoRemessaSimbolicaAssistencia: Código da transação de assistência para remessa simbólica

CodTransacaoRemessaSimbolicaAssistenciaBonificada: Código da transação de assistência bonificada para remessa simbólica

CodTransacaoRemessaTerceiroVenda: Código da transação de Venda bonificada para remessa ao terceiro

CodTransacaoRemessaTerceiroAssistencia: Código da transação de assistência para remessa ao terceiro

CodTransacaoRemessaTerceiroAssistenciaBonificada: Código da transação de assistência bonificada para remessa ao terceiro

CodClassificacaoAssBonificada: Código da classificação da assistência quando for bonificada

CodigoStatusEnvioDadosEtiqueta: Código do status a ser atribuído ao documento após sincronizar dados dos itens para emissão da etiqueta

NF_FormaEmissao: Forma de emissão da nota fiscal. Informe 0 para emissão normal e 1 para contingência

NF_DiasDataSaida: Quantidade de dias a somar na data de saída da nota fiscal

NF_CodModelo: Código do modelo para emissão da nota fiscal (menu Utilitários > Modelos de Documentos > Nota Fiscal Fatura/CTRC. É o autoinc)

MensagemNfeSimbolica: Utilizar a padrão: "Dados da NF do originário/Chave de acesso: NF NUM: <NFE> EMISSÃO: <DATAEMISSAO> SERIE: <SERIE> CHAVE: <CHAVENFE>"

Configurações Venda à Ordem onde o canal de integração emite as notas fiscais em razão da empresa

DiretorioXmlNotasFiscais: Informar o local onde os XML serão gravados para importação através do módulo Livro Fiscal.

CodigoLayoutImportacaoXmlNotasFiscais: Caso tenha algum layout personalizado, informe o código dele aqui. * Cuidado com essa configuração.

Exemplo de configuração

 {  
   "URL":"https://ecommerces.teksystem.com.br:8090/api/v1/",
   "Token":"xxxxxxxxxxxxxxxxxxxxxxxxxx",
   "VendaOrdem": false,            
   "CodTagMarcaProduto":42,
   "CodTagCompartilhaSaldoItem":26,
   "CodTagOrdemDeMontagemItem":10,
   "CodTagQtdeMaximaAMontar": 7,
   "CodTagQtdeReservadoAEmpresa":19,
   "CodTagVendaSemEstoque": 44,
   "CodTagTempoEntregaSemEstoque": 45,
   "CodTagTempoEntregaComEstoque": 46,
   "CodStatusInativo":"1",
   "CodStatusDetalhamentoNaoEnviadoParaEcommerce":39,
   "AbaterAoSaldoFisico":0,
   "TransacaoVenda": 1,
   "CodTabPrecos":365,
   "CodCondicaoPrecoVenda":23,
   "ModalidadeFrete": 2,
   "CodCondicaoPrecoDe":1,
   "CodCondicaoPrecoSemImpostos": 0,
   "CanaisDisponiveis":["TRAYCORP", "MARABRAZ"],
   "UsuariosNotificacoes":"DANILO",
   "EmailsNotificacoes":"",
   "EmpresasParaEnvioEstoque":"1", 
   "EmpresasDocAbatEstoque":"1", 
   "UtilizaPrazosDaCondicaoPagamentoTabelaPreco": true,
   "GravarEnderecoEntregaObservacaoNF": false,
   "Configuracoes_por_empresa":[],
   "CalcularPrevisaoImpostos": false,  
   "CodigoOutCampoQtdMaximaDetalhe": 5,  
   "CodTributacaoEspecialNaoContribuinte":7,
   "CodTributacaoEspecialContribuinte":5,    
   "CodMotivoPadraoAssistencia":1, 
   "CodOutCampoPagamento": 39,    
   "Configuracoes_por_canal":[  
       {  
           "canal":"INTEGRACOMMERCE",
           "CodOrgao": 30,
           "CodPessoaIntermediario": 7,
           "IdentificacaoCanalIntermediario": "USUARIO CANAL".
           "CodigoFamiliaItem": 0
       },
       {
           "canal":"PRECODE",
           "CodOrgao":17,
           "CodTagCompartilhaSaldoItem":4,
           "CodTabPrecos":16,
           "CodCondicaoPrecoDe": 7,
           "CodCondicaoPrecoVenda":8,
           "CodCondicaoPrecoVendaPorLoja": [
               {
                   "loja": "Magalu",
                   "CodCondicaoPrecoVenda":9,
                   "nomeLojaPedido": "Magazine Luiza"
               },
               {
                  "loja": "B2W",
                   "CodCondicaoPrecoVenda": 10,
                   "nomeLojaPedido": "B2W 2"
               },
               {
                   "loja": "Leroy",
                   "CodCondicaoPrecoVenda":11,
                   "nomeLojaPedido": "Leroy Merlin"
               }
           ]
       },
       {  
           "canal":"MARABRAZ",
           "VendaOrdem": true,
           "CodOrgao":23,
           "CodPessoaIntermediario": 13,
           "IdentificacaoCanalIntermediario": "USUARIO CANAL",
           "CodTagCompartilhaSaldoItem":27,
           "CodTransacaoRemessaSimbolicaVenda":131,
           "CodTransacaoRemessaSimbolicaAssistencia":132,
           "CodTransacaoRemessaSimbolicaAssistenciaBonificada":133,
           "CodTransacaoRemessaTerceiroVenda":134,
           "CodTransacaoRemessaTerceiroAssistencia":135,
           "CodTransacaoRemessaTerceiroAssistenciaBonificada":136,
           "CodTributacaoEspecialNaoContribuinte":7,
           "CodTributacaoEspecialContribuinte":5,
           "CodClassificacaoAssBonificada":21,
           "CodMotivoPadraoAssistencia":1,
           "CodigoStatusEnvioDadosEtiqueta": 36,
           "NF_FormaEmissao":0,
           "NF_DiasDataSaida":-1,
           "NF_CodModelo":2,
           "ModalidadeFrete": 2,
           "MensagemNfeSimbolica":"Dados da NF do originário/Chave de acesso: NF NUM: <NFE> EMISSÃO: <DATAEMISSAO> SERIE: <SERIE> CHAVE: <CHAVENFE>",
           "CustoPelaTabelaPreco": false
      }
   ]
 }