(Desenvolvimento) Ideris

Documentação e suporte


Autenticação


O que é sincronizado?


Envio de marcas

Resource Método
brand POST
brand PUT
Regras para envio
Opções na Configuração
Dados enviados

Tag de envio

O que será enviado

id

Id da marca na Ideris

description 

Descrição da marca

Tratamento de retorno
Operação Dado Base de dados ERP
Tabela de controle   IntegracãoEcommerce_Marca
Grava no ERP o id da marca na Ideris Id retornado IntegracaoEcommerce_Marca.IdMarcaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da marca data e hora atual IntegracaoEcommerce_Marca.DataHoraUltimaSinc

Envio de departamentos

Resource Método
department POST
department PUT
Regras para envio
Opções na Configuração
Dados enviados

Tag de envio

O que será enviado

id

Id do departamento na Ideris

name 

Descrição da família no ERP

Tratamento de retorno
Operação Dado Base de dados ERP
Tabela de controle   IntegracãoEcommerce_Familia
Grava no ERP o id do departamento na Ideris Id retornado IntegracaoEcommerce_Familia.IdFamiliaEcommerce
Grava/atualiza no ERP a data da ultima sincronização da familia data e hora atual IntegracaoEcommerce_Familia.DataHoraUltimaSinc

Envio de NCM

Resource Método
ncm POST
ncm PUT
Regras para envio
Opções na Configuração
Dados enviados

Tag de envio

O que será enviado

id

Id do NCM na Ideris

name 

Descrição da classificação fiscal no ERP

code

Classificação fiscal no ERP

Tratamento de retorno
Operação Dado Base de dados ERP
Tabela de controle   IntegracãoEcommerce_NCM
Grava no ERP o id do NCN na Ideris Id retornado IntegracaoEcommerce_NCM.IdNCMEcommerce
Grava/atualiza no ERP a data da ultima sincronização do NCM data e hora atual IntegracaoEcommerce_NCM.DataHoraUltimaSinc

Envio de categorias

Resource Método
category POST
category PUT
Regras para envio
Opções na Configuração
Dados enviados

Tags de envio

O que será enviado

id

Id da categoria na Climba

name

descrição do grupo ou catálogo

parentCategoryId

Id do grupo ou catalogo pai no ERP

Tratamento de Retorno
Operação Dado Base de dados ERP
Tabela de controle   IntegracaoEcommerce_Grupo/IntegracaoEcommerce_Catalogo
Grava no ERP o id da categoria na Ideris Id retornado IntegracaoEcommerce_Grupo.IdGrupoEcommerce/ IntegracaoEcommerce_Catalogo.IdCatalogoEcommerce
Grava/atualiza no ERP a data da ultima sincronização do grupo ou catálogo data e hora atual IntegracaoEcommerce_Grupo.DataHoraUltimaSinc/ IntegracaoEcommerce_Catalogo.DataHoraUltimaSinc

 


Envio de itens (SKU)

Resource Método
sku POST
sku PUT
Regras para envio
Opções na Configuração
Dados enviados

Tags de envio

O que será enviado

id

Id do item na Ideris

sku

Id do item ou referencia no ERP

title

Descrição do item no ERP

type

"SIMPLES"

updateStockListings

"True"

updateStockKit

"True"

ean

Código de barras do item

ncmId

Id da Ideris vinculado ao NCM do item

originId

Origem do item

stocks

tag do estoque

  currentStock

Quantidade em estoque do item

Tratamento de Retorno
Operação Dado Base de dados ERP
Tabela de controle   IntegracaoEcommerce_Item
Grava no ERP o id do item na Ideris Id retornado IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item data e hora atual IntegracaoEcommerce_Item.DataHoraUltimaSinc

Criação\Edição de modelo de anúncio por SKU

Resource Método
ListingModel POST
ListingModel PUT
Regras para criação\edição
Opções na Configuração
Dados enviados

Tags de envio

O que será enviado

id

Id do modelo do anuncio do item na Ideris

title

Descrição do item no ERP

brandId

Id da Ideris vinculado a marca do item

categoryId

Id da Ideris vinculado ao grupo ou catalogo do item

departmentId

Id da Ideris vinculado a familia do item

statusId

"1" - Ativo

type

"SIMPLES"

SKUId

Id do SKU inserido na Ideris

SKU

Id do item ou referencia no ERP

quantity

Quantidade em estoque do item

longDescription

Descrição técnica do item

weight

Peso líquido do item

length

Comprimento da embalagem do item

width

Largura da embalagem do item

height

Altura da embalagem do item

weightPackage

Peso bruto do item

lengthPackage

Comprimento da embalagem do item

widthPackage

Largura da embalagem do item

heightPackage

Altura da embalagem do item

cost

Valor do custo médio unitário do item

value

Preço do item

listingModelImage

Tag de imagens

  Base64

Imagens do item em base 64

Tratamento de Retorno
Operação Dado Base de dados ERP
Tabela de controle   IntegracaoEcommerce_Item
Grava no ERP o id do item na Ideris Id retornado IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item data e hora atual IntegracaoEcommerce_Item.DataHoraUltimaSinc
 

Busca de pedidos

Regras
Opções na Configuração
Dados usados para criar o pedido

Tag de retorno

Campo correspondente

id

Id do pedido pda

originName

nome do marketplace

totalAmount

Valor total do pedido

totalAmount

Valor total dos itens

discount

Valor do desconto

feeShipment

Valor do frete

feeShipment

Tarifa envio Ideris

feeOrder

Tarifa venda Ideris

Item do pedido

Regras
Dados usados para criar os itens

Tag de retorno

Campo correspondente

Base de dados

id

id do pedido na Ideris

pedido_item.idpedidopda

codeProduct

Sku do item na Ideris

iditem ou referencia

quantity

Quantidade do item

pedido_item.qt

unitPrice

Valor unitario do item

pedido_item.valor

unitPrice

Valor de pauta

pedido_item.valorpauta

unitPrice

Valor sugerido

pedido_item.valorsugerido

quantity * unitPrice

Valor total do item

pedido_item.valortotal

discount

Valor do desconto  rateado nos itens

pedido_item.valordesconto

discount/quantity * unitPrice

Percentual do desconto

pedido_item.perc_desconto

Cliente do pedido

Regras 
Opções na Configuração
Dados usados para criar o cliente

Tag de retorno

Campo correspondente

"Cadastrado via Ideris"

Observação

documentType

CPF ou CNPJ

ie

"ISENTO"

im

"ISENTO"

customerFirstName + customerLastName

Fantasia

customerLastName

Razão

customerEmail

e-mail

customerEmail

e-mail de nfe

phoneAreaCode + phoneNumber

Fone

addressStreet

Endereço

addressNumber

Número

addressComment

Complemento
districtName Bairro

stateAbbreviation

UF

addressZipCode

CEP

cityName

Nome da Cidade

Envio de Nota fiscal

Resource Método
order/<id do pedido pda>/invoice POST
Regras 
Opções na Configuração
Dados enviados

Tag de envio

O que será enviado

orderId

Id do pedido na Ideris 

number

Número da Nota

key

Chave eletrônica da nota

serie

Série da nota

xml

XML da Nota - base 64

issueAt

Data de emissão da nota

statusId

"1021" - Nota autorizada

cfop

Envia código CFOP somente se o marketplace for "Shopee"

MoveToInTransit

"False"


Atualiza status do pedido na Ideris

Resource Método
order PUT
Regras 
Dados enviados

Tag de envio

O que será enviado

orderId

Id do pedido na Ideris

statusId

1009 - Expedição

 

 




Revisão #15
Criado 23 November 2023 12:21:04 por Jackeline
Atualizado 5 December 2023 15:14:09 por Jackeline