Mudanças entre as edições de "Configuração da unit APIECOMMERCES CONFIGURACAO"
(11 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 | ||
''' | '''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 | ||
''' | '''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 | '''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 131: | Linha 147: | ||
'''MensagemNfeSimbolica''': Utilizar a padrão: "Dados da NF do originário/Chave de acesso: NF NUM: <NFE> EMISSÃO: <DATAEMISSAO> SERIE: <SERIE> CHAVE: <CHAVENFE>" | '''MensagemNfeSimbolica''': Utilizar a padrão: "Dados da NF do originário/Chave de acesso: NF NUM: <NFE> EMISSÃO: <DATAEMISSAO> SERIE: <SERIE> CHAVE: <CHAVENFE>" | ||
== Venda à Ordem onde o canal de integração emite as notas fiscais em razão da empresa == | == 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. | '''DiretorioXmlNotasFiscais''': Informar o local onde os XML serão gravados para importação através do módulo Livro Fiscal. | ||
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 } ] }