Configuração da unit APIECOMMERCES CONFIGURACAO

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
      }
   ]
 }

Informações Adicionais

==>> TRANSAÇÃO POR ORIGEM

Ao efetuar a importação de pedidos, passando pela APIECOMMERCE 2 campos extras que são

* Código da Transação do Pedido
* Código da Transação da Assistência 

Eles estarão vinculados a Origem de Pedidos (Cadastros /Informações comerciais /Origem de pedidos)

Neste campo deverá ser vinculado o código da transação desejada. Caso fique Zero(0) continuara a buscar a transação padrão do ERP ou da Unit de configuração (Caso de venda a ordem)