(Desenvolvimento) Magento

Documentação e suporte


Autenticação


O que é sincronizado?


Envio de marcas

Resource Método
brands POST
brands/<Id da marca na Climba> PUT
Regras para envio
Opções na Configuração
Dados enviados

Tag de envio

O que será enviado

id

Id da marca na Climba

name 

Descrição da marca

description 

Null

Tratamento de retorno
Operação Dado Base de dados ERP
Tabela de controle   IntegracãoEcommerce_Marca
Grava no ERP o id da marca na Climba 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 categorias

Resource Método
categories POST
categories/<Id da categoria na Climba> PUT
Regras para envio
Opções na Configuração
Dados enviados

Tags de envio

O que será enviado

id

Id da categoria na Climba

parentId

Id do grupo ou catalogo pai no ERP

name

descrição do grupo ou catálogo

order

Classificacao do grupo ou catalogo

description 

Null

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 Climba 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 simples

Resource Método
products POST
products/<Id do item no ERP> PUT
Regras para envio
Opções na Configuração
Dados enviados

Tags de envio

O que será enviado

id

Id do item no ERP

status

Status do item no ERP: 1-Atuvo/0-Inativo

categories

Id da climba vinculado ao grupo/catalogo do item

brandId

Id da climba vinculado a marca do item

name

Descrição, descrição técnica, observação ou complemento

description

Observação do item

productVariants

-

   sku

Id do item ou referencia

   internalCode

Id do item no ERP

   quantity

Quantidade em estoque do item

   description

Observação do item

   grossWeight

Peso bruto do item

   netWeight

Peso liquido do item

   height

Altura do item

   width

Largura do item

   length

Comprimento do item

   prices

-

      priceListId

"1"

      price

Preço do item

      priceFrom

"0"

  attributes

-

      id    

"1"

      name

"U"

      attributeGroupId

"1"

      id

"1"

      name

"U"

      attributeGroupId

"2"

  barCode

Código de barra 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 Climba Id retornado IntegracaoEcommerce_Item.IdItemEcommerce
Grava/atualiza no ERP a data da ultima sincronização do item data e hora atual IntegracaoEcommerce_Item.DataHoraUltimaSinc
Envio das fotos do itens simples
Resource Método
products/<Id do item no ERP>/pictures DELETE
products/<id do item do ERP>/pictures/base64 POST
Regras para envio

Tags de envio

O que será enviado

image Foto do item em base64
position Id da foto do item no ERP
Tratamento de Retorno
Operação Dado Base de dados ERP
Grava/atualiza no ERP a data da ultima sincronização do item data e hora atual Item.DataHoraUltimaSincClimbaFoto
 

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

id

Numero do pedido

customerComment

Observação

shippingAddress/state

UF de destino

name

nome do cliente

sourceId

id marketplace

totalValue

Valor total do pedido

totalValue

Valor total dos itens

discountValue

Valor do desconto

additionValue

Valor do acréscimo

shippingValue

Valor do frete

payment/id

Id do método de pagto

payment/installmentQuantity

Parcela do método

shipping/id

Id da transportadora

Item do pedido

Regras
Dados usados para criar os itens

Tag de retorno

Campo correspondente

Base de dados

sequence

sequencial do item no pedido

pedido_item.sequencial

sequence

sequencial do item no pedido

pedido_item.idpedidoitem

id

id do pedido na climba

pedido_item.idpedidopda

sku

Sku do item na climba

 

productId

Id do item no ERP

 

quantity

Quantidade do item

pedido_item.qt

sellingPrice

Valor unitario do item

pedido_item.valor

sellingPrice

Valor de pauta

pedido_item.valorpauta

sellingPrice

Valor sugerido

pedido_item.valorsugerido

quantity * sellingPrice

Valor total do item

pedido_item.valortotal

discountValue

Valor do desconto 

pedido_item.valordesconto

discountValue/quantity * sellingPrice

Percentual do desconto

pedido_item.perc_desconto

additionValue

Valor de acrescimo 

pedido.valoracrescimo

additionValue/quantity * sellingPrice

Percentual de acrescimo

pedido_item.perc_acrescimo

Cliente do pedido

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

Tag de retorno

Campo correspondente

"Cadastrado via Climba"

Observação

birthDate

Data de nascimento

id

Id do cliente na Climba

name

Fantasia

name

Razão

gender  = "m" ou "f"

Sexo

email

e-mail

email

e-mail NF-e

documents/ type 

-

   type  = "cpf"

      number

CPF

   type = "cnpj"

-

      number

CNPJ

  type = "ie"

-

      number

IE

  type = "rg"

 

      number

RG

phones

 

  type = "primary"

 

      number

Fone

  type = "secundary"

 

      number

Fone 2

  type = "others"

 

      number

Fax

shippingAddress

 

  street

Endereço

  streetNumber

Número

  complement

Complemento

  district

Bairro

  state

UF

  zipCode

CEP

  city

Nome da Cidade

Envio de Nota fiscal

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

Tag de envio

O que será enviado

number

Número da NFS

nfeAccessKey

Chave eletrônica da NFS

xml

XML da NFS

logisticOperatorId

Id da Operador logistico informada na configuração. Se não envia vazio.

 

 

 


Revisão #2
Criado 4 December 2023 13:43:42 por Jackeline
Atualizado 5 December 2023 15:43:32 por Jackeline