Olist Tiny (API v3)

Adicionando a fonte de dados

Requisitos

  • Conta no Olist Tiny (Tiny ERP) com acesso à criação de aplicativos de API (área "aplicativos api" das configurações)

Instruções

  1. Acesse https://erp.olist.com/aplicativos_api#/add para criar um novo aplicativo
  2. Em Nome do aplicativo, dê um nome para identificar o aplicativo (por exemplo, Kondado)
  3. Em URL de Redirecionamento, coloque https://app.kondado.com.br/sources/new/133
  4. Em Permissões do aplicativo, marque todos os escopos necessários ou selecione Marcar todos (os escopos que cada integração utiliza estão listados nas notas de cada integração, mais abaixo nesta página)
    1. Tela de criação do aplicativo de API no Olist Tiny, com nome do aplicativo, URL de redirecionamento e permissões
  5. Clique em salvar — as chaves de acesso (Client ID e Client Secret) serão geradas
  6. Faça login na Kondado, vá para a seção de adicionar conectores e selecione o conector do Olist Tiny
  7. Então coloque o Client ID e o Client Secret gerados e clique em Próximo e depois autorize o acesso na tela do Olist Tiny

Pipelines

Resumo

Diagrama de relacionamento

Clique para expandir

CRM: assuntos

Escopos necessários no aplicativo do Olist Tiny: CRM (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Listagem de assuntos do CRM com datas, cliente, estágio e próxima ação.

Campo Tipo

id

text

[pt] Identificador do assunto do CRM.

assunto

text

[pt] Título ou descrição do assunto.

data

date

[pt] Data de criação do assunto.

dataatualizacao

date

[pt] Data da última atualização do assunto.

cliente_statuscrm

text

[pt] Status do cliente no CRM.

estrela

text

[pt] Classificação por estrela ou marcador de destaque.

arquivado

text

[pt] Indica se o assunto está arquivado.

totalacoes

float

[pt] Número total de ações vinculadas ao assunto.

totalanotacoes

float

[pt] Número total de anotações vinculadas ao assunto.

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

estagio_id

text

[pt] Identificador do estágio do CRM.

    CRM: estagios > > id

estagio_descricao

text

[pt] Descrição do estágio do CRM.

proximaacao_data

text

[pt] Data da próxima ação agendada.

proximaacao_descricao

text

[pt] Descrição da próxima ação agendada.

proximaacao_tipo

text

[pt] Tipo da próxima ação agendada.

CRM: assuntos detalhes

Escopos necessários no aplicativo do Olist Tiny: CRM (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Incluir marcadores?: Se deseja incluir uma tabela com os marcadores de cada assunto. Cada assunto exige uma leitura extra na Tiny para buscar os marcadores, então desligar deixa a integração mais rápida.
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Objeto principal

Detalhes do assunto do CRM com datas, estrela, status de arquivamento, cliente e estágio. Inclui também todos os campos da integração "Assuntos do CRM", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador do assunto do CRM.

    CRM: assuntos > > id

assunto

text

[pt] Título ou descrição do assunto.

data

date

[pt] Data de criação do assunto.

dataatualizacao

date

[pt] Data da última atualização do assunto.

estrela

text

[pt] Classificação por estrela ou marcador de destaque.

arquivado

text

[pt] Indica se o assunto está arquivado.

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

estagio_id

text

[pt] Identificador do estágio do CRM.

    CRM: estagios > > id

estagio_descricao

text

[pt] Descrição do estágio do CRM.

cliente_statuscrm

text

[pt] Status do cliente no CRM.

totalacoes

float

[pt] Número total de ações vinculadas ao assunto.

totalanotacoes

float

[pt] Número total de anotações vinculadas ao assunto.

proximaacao_data

text

[pt] Data da próxima ação agendada.

proximaacao_descricao

text

[pt] Descrição da próxima ação agendada.

proximaacao_tipo

text

[pt] Tipo da próxima ação agendada.

tinyerp_crm_assuntos_detalhes_acoes

Ações vinculadas a um assunto do CRM.

Campo Tipo

assunto_id

text

[pt] Identificador do assunto do CRM pai.

    CRM: assuntos detalhes > > id

id

text

[pt] Identificador da ação.

descricao

text

[pt] Descrição da ação.

data

text

[pt] Data da ação.

usuario_responsavel_id

text

[pt] Identificador do usuário responsável pela ação.

usuario_responsavel_nome

text

[pt] Nome do usuário responsável pela ação.

tinyerp_crm_assuntos_detalhes_anotacoes

Anotações vinculadas a um assunto do CRM.

Campo Tipo

assunto_id

text

[pt] Identificador do assunto do CRM pai.

    CRM: assuntos detalhes > > id

id

text

[pt] Identificador da anotação.

anotacao

text

[pt] Conteúdo da anotação.

usuario

text

[pt] Usuário que criou a anotação.

data

text

[pt] Data da anotação.

tinyerp_crm_assuntos_detalhes_marcadores

Marcadores (etiquetas) vinculados a um assunto do CRM.

Campo Tipo

assunto_id

text

[pt] Identificador do assunto do CRM pai.

    CRM: assuntos detalhes > > id

descricao

text

[pt] Descrição do marcador.

cor

text

[pt] Cor do marcador (hex).

CRM: estagios

Escopos necessários no aplicativo do Olist Tiny: CRM (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Estágios do CRM com descrição e ordem.

Campo Tipo

id

text

[pt] Identificador do estagio do CRM.

descricao

text

[pt] Descricao do estagio.

ordem

text

[pt] Ordem de exibicao do estagio.

Categorias de produtos

Escopos necessários no aplicativo do Olist Tiny: Categorias (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

Árvore de categorias de produtos com descrição e categoria pai.

Campo Tipo

id

text

[pt] Identificador da categoria.

descricao

text

[pt] Descrição da categoria.

idcategoriapai

text

[pt] Identificador da categoria pai.

    Categorias de produtos > > id

Categorias: receitas e despesas

Escopos necessários no aplicativo do Olist Tiny: Categorias de receita e despesa (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Categorias de receita e despesa com descrição e grupo.

Campo Tipo

id

text

[pt] Identificador da categoria.

descricao

text

[pt] Descrição da categoria.

grupo

text

[pt] Grupo da categoria (receita ou despesa).

Contas a pagar

Escopos necessários no aplicativo do Olist Tiny: Contas a pagar (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos
  • Janela passada (dias): Quantos dias para tras a partir do savepoint buscar dados por data de vencimento
  • Janela futura (dias): Quantos dias para frente buscar dados por data de vencimento

Relacionamentos:

Listagem de contas a pagar com situação, datas, número do documento, valor, saldo e cliente.

Campo Tipo

id

text

[pt] Identificador único da conta a pagar.

situacao

text

[pt] Situação do pagamento (aberto, pago, cancelado, etc.).

data

date

[pt] Data de emissão da conta a pagar.

datavencimento

date

[pt] Data de vencimento.

numerodocumento

text

[pt] Número do documento.

seriedocumento

text

[pt] Série do documento.

historico

text

[pt] Histórico ou descrição do pagamento.

valor

float

[pt] Valor original.

saldo

float

[pt] Saldo em aberto.

cliente_id

text

[pt] Identificador do fornecedor/contato.

    Contatos > > id

cliente_nome

text

[pt] Nome do fornecedor/contato.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do fornecedor/contato.

Contas a pagar: detalhes

Escopos necessários no aplicativo do Olist Tiny: Contas a pagar (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos
  • Janela passada (dias): Quantos dias para tras a partir do savepoint buscar dados por data de vencimento
  • Janela futura (dias): Quantos dias para frente buscar dados por data de vencimento

Relacionamentos:

Objeto principal

Detalhes de contas a pagar com datas, ocorrência, parcelas, valores, contato, categoria e forma de pagamento. Inclui também todos os campos da integração "Contas a pagar", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador único da conta a pagar.

    Contas a pagar > > id

situacao

text

[pt] Situação do pagamento (aberto, pago, cancelado, etc.).

data

date

[pt] Data de emissão da conta a pagar.

datavencimento

date

[pt] Data de vencimento.

datacompetencia

date

[pt] Data de competência (granularidade mensal; normalizada para o dia 1º do mês).

dataliquidacao

date

[pt] Data de liquidação.

diavencimento

text

[pt] Dia do vencimento.

diasemanavencimento

text

[pt] Dia da semana do vencimento.

numerodocumento

text

[pt] Número do documento.

seriedocumento

text

[pt] Série do documento.

ocorrencia

text

[pt] Tipo de ocorrência (única ou recorrente).

quantidadeparcelas

text

[pt] Quantidade de parcelas.

valor

float

[pt] Valor original.

saldo

float

[pt] Saldo em aberto.

valorpago

float

[pt] Valor pago.

multa

float

[pt] Valor da multa.

juros

float

[pt] Valor dos juros.

desconto

float

[pt] Desconto concedido na baixa, calculado como valor + multa + juros - valorPago - saldo (somente para contas pagas com valor pago registrado; nulo nos demais casos).

historico

text

[pt] Histórico ou descrição do pagamento.

contato_id

text

[pt] Identificador do fornecedor/contato.

    Contatos > > id

contato_nome

text

[pt] Nome do fornecedor/contato.

contato_cpfcnpj

text

[pt] CPF ou CNPJ do fornecedor/contato.

categoria_id

text

[pt] Identificador da categoria de receita/despesa.

    Categorias: receitas e despesas > > id

categoria_descricao

text

[pt] Descrição da categoria de receita/despesa.

formapagamento_id

text

[pt] Identificador da forma de pagamento.

    Formas de pagamento > > id

formapagamento_descricao

text

[pt] Descrição da forma de pagamento.

cliente_id

text

[pt] Identificador do fornecedor/contato.

    Contatos > > id

cliente_nome

text

[pt] Nome do fornecedor/contato.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do fornecedor/contato.

tinyerp_contas_pagar_detalhes_marcadores

Marcadores da conta a pagar, para categorização (ex.: banco, alerta ou tag de acompanhamento aplicada ao lançamento).

Campo Tipo

conta_id

text

[pt] Identificador da conta a pagar pai.

    Contas a pagar: detalhes > > id

descricao

text

[pt] Descrição do marcador.

Contas a receber

Escopos necessários no aplicativo do Olist Tiny: Contas a receber (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos
  • Janela passada (dias): Quantos dias para tras a partir do savepoint buscar dados por data de vencimento
  • Janela futura (dias): Quantos dias para frente buscar dados por data de vencimento

Relacionamentos:

Listagem de contas a receber com situação, datas, número do documento, valor, saldo e cliente.

Campo Tipo

id

text

[pt] Identificador único da conta a receber.

situacao

text

[pt] Situação do recebimento (aberto, recebido, cancelado, etc.).

data

date

[pt] Data de emissão da conta a receber.

datavencimento

date

[pt] Data de vencimento.

numerodocumento

text

[pt] Número do documento.

seriedocumento

text

[pt] Série do documento.

numerobanco

text

[pt] Número do banco.

historico

text

[pt] Histórico ou descrição do recebimento.

valor

float

[pt] Valor original.

saldo

float

[pt] Saldo em aberto.

quantidadeparcelasantecipadas

text

[pt] Quantidade de parcelas antecipadas.

cliente_id

text

[pt] Identificador do cliente/contato.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente/contato.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente/contato.

Contas a receber: detalhes

Escopos necessários no aplicativo do Olist Tiny: Contas a receber (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos
  • Incluir marcadores?: Se deseja incluir uma tabela com os marcadores de cada conta a receber. Cada lançamento passa a exigir uma leitura extra na Tiny, então a integração fica mais lenta.
  • Janela passada (dias): Quantos dias para tras a partir do savepoint buscar dados por data de vencimento
  • Janela futura (dias): Quantos dias para frente buscar dados por data de vencimento

Relacionamentos:

Objeto principal

Detalhes de contas a receber com datas, ocorrência, parcelas, valores, cliente, categoria e forma de recebimento. Inclui também todos os campos da integração "Contas a receber", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador único da conta a receber.

    Contas a receber > > id

situacao

text

[pt] Situação do recebimento (aberto, recebido, cancelado, etc.).

data

date

[pt] Data de emissão da conta a receber.

datavencimento

date

[pt] Data de vencimento.

datacompetencia

date

[pt] Data de competência (granularidade mensal; normalizada para o dia 1º do mês).

dataliquidacao

date

[pt] Data de liquidação.

diavencimento

text

[pt] Dia do vencimento.

diasemanavencimento

text

[pt] Dia da semana do vencimento.

numerodocumento

text

[pt] Número do documento.

seriedocumento

text

[pt] Série do documento.

numerobanco

text

[pt] Número do banco.

ocorrencia

text

[pt] Tipo de ocorrência (única ou recorrente).

quantidadeparcelas

text

[pt] Quantidade de parcelas.

quantidadeparcelasantecipadas

text

[pt] Quantidade de parcelas antecipadas.

valor

float

[pt] Valor original.

saldo

float

[pt] Saldo em aberto.

taxa

float

[pt] Valor da taxa.

juros

float

[pt] Valor dos juros.

multa

float

[pt] Valor da multa.

valorpago

float

[pt] Valor pago.

historico

text

[pt] Histórico ou descrição do recebimento.

linkboleto

text

[pt] Link do boleto.

cliente_id

text

[pt] Identificador do cliente/contato.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente/contato.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente/contato.

categoria_id

text

[pt] Identificador da categoria de receita/despesa.

    Categorias: receitas e despesas > > id

categoria_descricao

text

[pt] Descrição da categoria de receita/despesa.

formarecebimento_id

text

[pt] Identificador da forma de recebimento.

    Formas de recebimento > > id

formarecebimento_descricao

text

[pt] Descrição da forma de recebimento.

tinyerp_contas_receber_detalhes_marcadores

Marcadores da conta a receber, para categorização. Só é criada quando a opção "Incluir marcadores?" está ativada na configuração da integração, porque aí cada lançamento exige uma leitura extra.

Campo Tipo

conta_id

text

[pt] Identificador da conta a receber pai.

    Contas a receber: detalhes > > id

descricao

text

[pt] Descrição do marcador.

Contatos

Escopos necessários no aplicativo do Olist Tiny: Contatos (acesso de Leitura)

Tipo de replicacao: Incremental

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Listagem de contatos com dados pessoais, endereço, vendedor, status CRM e tipo de contato.

Campo Tipo

id

text

[pt] Identificador único do contato.

nome

text

[pt] Nome completo ou razão social do contato.

fantasia

text

[pt] Nome fantasia.

codigo

text

[pt] Código de referência do contato.

cpfcnpj

text

[pt] Número do CPF ou CNPJ.

inscricaoestadual

text

[pt] Número da inscrição estadual.

rg

text

[pt] Número do RG.

email

text

[pt] Endereço de e-mail do contato.

celular

text

[pt] Número do celular.

telefone

text

[pt] Número do telefone fixo.

tipopessoa

text

[pt] Tipo de pessoa (física ou jurídica).

situacao

text

[pt] Situação do contato (ativo ou inativo).

statuscrm

text

[pt] Status do contato no CRM.

datacriacao

date

[pt] Data de criação do contato.

dataatualizacao

date

[pt] Data da última atualização do contato.

endereco_endereco

text

[pt] Logradouro do endereço.

endereco_numero

text

[pt] Número do endereço.

endereco_complemento

text

[pt] Complemento do endereço.

endereco_bairro

text

[pt] Bairro.

endereco_municipio

text

[pt] Município.

endereco_uf

text

[pt] Unidade federativa (UF).

endereco_cep

text

[pt] Código postal (CEP).

endereco_pais

text

[pt] País.

vendedor_id

text

[pt] Identificador do vendedor associado.

    Vendedores > > id

vendedor_nome

text

[pt] Nome do vendedor associado.

Contatos: detalhes

Escopos necessários no aplicativo do Olist Tiny: Contatos (acesso de Leitura)

Tipo de replicacao: Incremental

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Objeto principal

Detalhes do contato com dados pessoais, endereço de cobrança, pessoas de contato e tipos. Inclui também todos os campos da integração "Contatos", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador único do contato.

    Contatos > > id

datacriacao

date

[pt] Data de criação do contato.

dataatualizacao

date

[pt] Data da última atualização do contato.

datanascimento

text

[pt] Data de nascimento.

situacao

text

[pt] Situação do contato (ativo ou inativo).

statuscrm

text

[pt] Status do contato no CRM.

sexo

text

[pt] Sexo.

profissao

text

[pt] Profissão.

naturalidade

text

[pt] Naturalidade.

estadocivil

text

[pt] Estado civil.

observacoes

text

[pt] Observações adicionais.

site

text

[pt] URL do site.

emailnfe

text

[pt] E-mail para recebimento de NF-e.

inscricaomunicipal

text

[pt] Número da inscrição municipal.

limitecredito

float

[pt] Limite de crédito.

regimetributario

text

[pt] Regime tributário.

telefoneadicional

text

[pt] Telefone adicional.

nomepai

text

[pt] Nome do pai.

nomemae

text

[pt] Nome da mãe.

cpfpai

text

[pt] CPF do pai.

cpfmae

text

[pt] CPF da mãe.

enderecocobranca_endereco

text

[pt] Logradouro do endereço de cobrança.

enderecocobranca_numero

text

[pt] Número do endereço de cobrança.

enderecocobranca_complemento

text

[pt] Complemento do endereço de cobrança.

enderecocobranca_bairro

text

[pt] Bairro do endereço de cobrança.

enderecocobranca_municipio

text

[pt] Município do endereço de cobrança.

enderecocobranca_uf

text

[pt] UF do endereço de cobrança.

enderecocobranca_cep

text

[pt] CEP do endereço de cobrança.

enderecocobranca_pais

text

[pt] País do endereço de cobrança.

nome

text

[pt] Nome completo ou razão social do contato.

fantasia

text

[pt] Nome fantasia.

codigo

text

[pt] Código de referência do contato.

cpfcnpj

text

[pt] Número do CPF ou CNPJ.

inscricaoestadual

text

[pt] Número da inscrição estadual.

rg

text

[pt] Número do RG.

email

text

[pt] Endereço de e-mail do contato.

celular

text

[pt] Número do celular.

telefone

text

[pt] Número do telefone fixo.

tipopessoa

text

[pt] Tipo de pessoa (física ou jurídica).

endereco_endereco

text

[pt] Logradouro do endereço.

endereco_numero

text

[pt] Número do endereço.

endereco_complemento

text

[pt] Complemento do endereço.

endereco_bairro

text

[pt] Bairro.

endereco_municipio

text

[pt] Município.

endereco_uf

text

[pt] Unidade federativa (UF).

endereco_cep

text

[pt] Código postal (CEP).

endereco_pais

text

[pt] País.

vendedor_id

text

[pt] Identificador do vendedor associado.

    Vendedores > > id

vendedor_nome

text

[pt] Nome do vendedor associado.

tinyerp_contatos_detalhes_contatos

Pessoas de contato vinculadas ao contato principal com nome, cargo, e-mail e telefone.

Campo Tipo

contato_id

text

[pt] Identificador do contato pai.

    Contatos: detalhes > > id

id

text

[pt] Identificador único da pessoa de contato.

nome

text

[pt] Nome da pessoa de contato.

cargo

text

[pt] Cargo da pessoa de contato.

email

text

[pt] E-mail da pessoa de contato.

celular

text

[pt] Celular da pessoa de contato.

telefone

text

[pt] Telefone fixo da pessoa de contato.

tinyerp_contatos_detalhes_tipos

Tipos de contato (cliente, fornecedor, etc.) vinculados ao contato principal.

Campo Tipo

contato_id

text

[pt] Identificador do contato pai.

    Contatos: detalhes > > id

id

text

[pt] Identificador único do tipo.

descricao

text

[pt] Descrição do tipo.

Depositos

Escopos necessários no aplicativo do Olist Tiny: Depósitos (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Depósitos com nome, tipo e indicação de padrão.

Campo Tipo

id

text

[pt] Identificador único do depósito.

descricao

text

[pt] Descrição do depósito.

tipo

text

[pt] Tipo do depósito.

padrao

text

[pt] Indica se o depósito é o padrão.

desconsidera_saldo

text

[pt] Indica se desconsidera o saldo em estoque.

possui_reserva

text

[pt] Indica se o depósito possui reserva de estoque.

Estoque

Escopos necessários no aplicativo do Olist Tiny: Produtos, Estoque (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

Objeto principal

Estoque de produtos com saldo, reservado, disponível, localização e depósitos.

Campo Tipo

id

text

[pt] Identificador do produto.

    Produtos > > id

codigo

text

[pt] Código do produto (SKU).

nome

text

[pt] Nome do produto.

unidade

text

[pt] Unidade de medida.

localizacao

text

[pt] Localização do estoque.

saldo

float

[pt] Saldo total do estoque.

reservado

float

[pt] Quantidade reservada do estoque.

disponivel

float

[pt] Quantidade disponível do estoque.

tinyerp_estoque_depositos

Detalhamento do estoque por depósito com saldo, reservado e disponível.

Campo Tipo

produto_id

text

[pt] Identificador do produto.

    Produtos > > id

id

text

[pt] Identificador do depósito.

    Depositos > > id

nome

text

[pt] Nome do depósito.

empresa

text

[pt] Apelido da empresa dona deste depósito (contas multiempresa).

desconsiderar

boolean

[pt] Se o saldo deste depósito é desconsiderado no estoque total do produto.

saldo

float

[pt] Saldo do estoque neste depósito.

reservado

float

[pt] Estoque reservado neste depósito.

disponivel

float

[pt] Estoque disponível neste depósito.

Expedicao

Escopos necessários no aplicativo do Olist Tiny: Expedição (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Listagem de expedições com identificação, data, quantidade de objetos e forma de envio.

Campo Tipo

id

text

[pt] Identificador da expedição.

identificacao

text

[pt] Rótulo de identificação da expedição.

data

date

[pt] Data da expedição.

quantidadeobjetos

float

[pt] Quantidade de objetos na expedição.

formaenvio_id

text

[pt] Identificador da forma de envio.

    Formas de envio > > id

formaenvio_descricao

text

[pt] Descrição da forma de envio.

Formas de envio

Escopos necessários no aplicativo do Olist Tiny: Logística (formas de envio) (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Formas de envio com nome, tipo, situação e gateway logístico.

Campo Tipo

id

text

[pt] Identificador único da forma de envio.

nome

text

[pt] Nome da forma de envio.

tipo

text

[pt] Tipo da forma de envio.

situacao

text

[pt] Situação da forma de envio.

gateway_logistico

text

[pt] Gateway logístico associado à forma de envio.

Formas de pagamento

Escopos necessários no aplicativo do Olist Tiny: Formas de pagamento (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Formas de pagamento com nome e situação.

Campo Tipo

id

text

[pt] Identificador único da forma de pagamento.

nome

text

[pt] Nome da forma de pagamento.

situacao

text

[pt] Situação da forma de pagamento.

Formas de recebimento

Escopos necessários no aplicativo do Olist Tiny: Formas de recebimento (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Formas de recebimento com nome e situação.

Campo Tipo

id

text

[pt] Identificador único da forma de recebimento.

nome

text

[pt] Nome da forma de recebimento.

situacao

text

[pt] Situação da forma de recebimento.

Grupos de tags

Escopos necessários no aplicativo do Olist Tiny: Grupos de Tags (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Grupos de tags com nome.

Campo Tipo

id

text

[pt] Identificador único do grupo de tags.

nome

text

[pt] Nome do grupo de tags.

Informacoes da empresa

Escopos necessários no aplicativo do Olist Tiny: Dados da empresa (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Informações da empresa com CNPJ, razão social e nome fantasia.

Campo Tipo

cpf_cnpj

text

[pt] CPF ou CNPJ da empresa.

razao_social

text

[pt] Razao social da empresa.

fantasia

text

[pt] Nome fantasia da empresa.

inscricao_estadual

text

[pt] Inscricao estadual da empresa.

regime_tributario

text

[pt] Regime tributario da empresa.

email

text

[pt] Email da empresa.

fone

text

[pt] Telefone da empresa.

endereco

text

[pt] Endereco da empresa.

endereco_numero

text

[pt] Numero do endereco.

endereco_complemento

text

[pt] Complemento do endereco.

endereco_bairro

text

[pt] Bairro do endereco.

endereco_cep

text

[pt] CEP do endereco.

endereco_municipio

text

[pt] Municipio do endereco.

endereco_uf

text

[pt] Unidade federativa (UF).

endereco_pais

text

[pt] Pais do endereco.

Intermediadores

Escopos necessários no aplicativo do Olist Tiny: Intermediadores (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Intermediadores/marketplaces com nome, CNPJ e canal de venda.

Campo Tipo

id

text

[pt] Identificador do intermediador.

nome

text

[pt] Nome do intermediador.

cnpj

text

[pt] CNPJ do intermediador.

canal_venda

text

[pt] Canal de venda do intermediador.

Listas de precos

Escopos necessários no aplicativo do Olist Tiny: Lista de Preços (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Listas de preços com descrição e acréscimo/desconto.

Campo Tipo

id

text

[pt] Identificador da lista de precos.

descricao

text

[pt] Descricao da lista de precos.

acrescimo_desconto

float

[pt] Percentual de acrescimo ou desconto.

Marcas

Escopos necessários no aplicativo do Olist Tiny: Marcas (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Marcas de produtos com descrição.

Campo Tipo

id

text

[pt] Identificador único da marca.

descricao

text

[pt] Descrição da marca.

Notas fiscais

Escopos necessários no aplicativo do Olist Tiny: Notas Fiscais (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Listagem de notas fiscais com tipo, situação, cliente, vendedor, e-commerce e origem.

Campo Tipo

id

text

[pt] Identificador único da nota fiscal.

tipo

text

[pt] Tipo da nota fiscal (ex: NFe, NFSe).

numero

text

[pt] Número da nota fiscal.

serie

text

[pt] Série da nota fiscal.

chaveacesso

text

[pt] Chave de acesso da nota fiscal.

situacao

text

[pt] Situação da nota fiscal.

dataemissao

date

[pt] Data de emissão da nota fiscal.

dataprevista

text

[pt] Data prevista.

valor

float

[pt] Valor total da nota fiscal.

valorfrete

float

[pt] Valor do frete.

valorprodutos

float

[pt] Valor total dos produtos.

pesobruto

float

[pt] Peso bruto.

pesoliquido

float

[pt] Peso líquido.

qtdvolumes

text

[pt] Quantidade de volumes.

codigorastreamento

text

[pt] Código de rastreamento.

urlrastreamento

text

[pt] URL de rastreamento.

freteporconta

text

[pt] Responsável pelo custo do frete.

idformaenvio

text

[pt] Identificador da forma de envio.

idformafrete

text

[pt] Identificador da forma de frete.

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente.

vendedor_id

text

[pt] Identificador do vendedor.

    Vendedores > > id

vendedor_nome

text

[pt] Nome do vendedor.

ecommerce_id

text

[pt] Identificador da plataforma de e-commerce.

ecommerce_nome

text

[pt] Nome da plataforma de e-commerce.

ecommerce_numeropedidoecommerce

text

[pt] Número do pedido na plataforma de e-commerce.

ecommerce_canalvenda

text

[pt] Nome do canal de venda.

origem_id

text

[pt] Identificador do pedido de origem.

    Pedidos > > id

origem_tipo

text

[pt] Tipo do documento de origem (ex.: venda).

Notas fiscais: detalhes

Escopos necessários no aplicativo do Olist Tiny: Notas Fiscais (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Objeto principal

Detalhes da nota fiscal com valores de impostos, cliente, vendedor, transportador, e-commerce, itens, parcelas e marcadores. Inclui também todos os campos da integração "Notas fiscais", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador único da nota fiscal.

    Notas fiscais > > id

tipo

text

[pt] Tipo da nota fiscal (ex: NFe, NFSe).

numero

text

[pt] Número da nota fiscal.

serie

text

[pt] Série da nota fiscal.

chaveacesso

text

[pt] Chave de acesso da nota fiscal.

situacao

text

[pt] Situação da nota fiscal.

dataemissao

date

[pt] Data de emissão da nota fiscal.

datainclusao

date

[pt] Data de inclusão da nota fiscal.

dataprevista

text

[pt] Data prevista.

valor

float

[pt] Valor total da nota fiscal.

valordesconto

float

[pt] Valor do desconto.

valorfrete

float

[pt] Valor do frete.

valorseguro

float

[pt] Valor do seguro.

valoroutras

float

[pt] Valor de outras despesas.

valorprodutos

float

[pt] Valor total dos produtos.

valorservicos

float

[pt] Valor total dos serviços.

valorfaturado

float

[pt] Valor faturado.

valornotacomimpostos

float

[pt] Valor da nota com impostos.

valoricms

float

[pt] Valor do ICMS.

valoricmsst

float

[pt] Valor do ICMS-ST.

baseicms

float

[pt] Base de cálculo do ICMS.

baseicmsst

float

[pt] Base de cálculo do ICMS-ST.

valoripi

float

[pt] Valor do IPI.

valorissqn

float

[pt] Valor do ISSQN.

valoripidevolvido

float

[pt] Valor do IPI devolvido.

valorbasediferimento

float

[pt] Valor base de diferimento.

percentualicmspartilhadestino

float

[pt] Percentual de partilha do ICMS para o destino.

valortotalicmsfcpdestino

float

[pt] Valor total do ICMS FCP destino.

valortotalibsuf

float

[pt] Valor total do IBS UF.

valortotalcbs

float

[pt] Valor total da CBS.

valortotalbcibscbs

float

[pt] Valor total da base de cálculo IBS/CBS.

pesobruto

float

[pt] Peso bruto.

pesoliquido

float

[pt] Peso líquido.

qtdvolumes

text

[pt] Quantidade de volumes.

regimetributario

text

[pt] Regime tributário.

finalidade

text

[pt] Finalidade da nota fiscal.

condicaopagamento

text

[pt] Condição de pagamento.

tiponotacredito

text

[pt] Tipo de nota de crédito.

tiponotadebito

text

[pt] Tipo de nota de débito.

observacoes

text

[pt] Observações da nota fiscal.

codigorastreamento

text

[pt] Código de rastreamento.

urlrastreamento

text

[pt] URL de rastreamento.

freteporconta

text

[pt] Responsável pelo custo do frete.

idformaenvio

text

[pt] Identificador da forma de envio.

idformafrete

text

[pt] Identificador da forma de frete.

idformapagamento

text

[pt] Identificador da forma de pagamento.

idmeiopagamento

text

[pt] Identificador do meio de pagamento.

idnaturezaoperacao

text

[pt] Identificador da natureza da operação.

idintermediador

text

[pt] Identificador do intermediário.

    Intermediadores > > id

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente.

vendedor_id

text

[pt] Identificador do vendedor.

    Vendedores > > id

vendedor_nome

text

[pt] Nome do vendedor.

ecommerce_id

text

[pt] Identificador da plataforma de e-commerce.

ecommerce_nome

text

[pt] Nome da plataforma de e-commerce.

origem_id

text

[pt] Identificador do pedido de origem.

    Pedidos > > id

origem_tipo

text

[pt] Tipo do documento de origem (ex.: venda).

transportador_nome

text

[pt] Nome do transportador.

transportador_cpfcnpj

text

[pt] CPF ou CNPJ do transportador.

ecommerce_numeropedidoecommerce

text

[pt] Número do pedido na plataforma de e-commerce.

ecommerce_canalvenda

text

[pt] Nome do canal de venda.

tinyerp_notas_detalhes_itens

Itens da nota fiscal com detalhes do produto, quantidades, valores e códigos fiscais.

Campo Tipo

nota_id

text

[pt] Identificador da nota fiscal pai.

    Notas fiscais: detalhes > > id

iditem

text

[pt] Identificador do item.

idproduto

text

[pt] Identificador do produto.

    Produtos > > id

codigo

text

[pt] Código do produto.

descricao

text

[pt] Descrição do item.

ncm

text

[pt] Código de classificação fiscal NCM.

cfop

text

[pt] Código CFOP da operação fiscal.

unidade

text

[pt] Unidade de medida.

quantidade

float

[pt] Quantidade do item.

valorunitario

float

[pt] Valor unitário.

valortotal

float

[pt] Valor total do item.

naturezaoperacao

text

[pt] Natureza da operação fiscal.

tinyerp_notas_detalhes_parcelas

Parcelas de pagamento da nota fiscal com datas de vencimento, valores e meios de pagamento.

Campo Tipo

nota_id

text

[pt] Identificador da nota fiscal pai.

    Notas fiscais: detalhes > > id

id

text

[pt] Identificador da parcela.

datavencimento

text

[pt] Data de vencimento da parcela.

dias

text

[pt] Dias até o vencimento.

numero

text

[pt] Número da parcela.

observacoes

text

[pt] Observações da parcela.

valor

float

[pt] Valor da parcela.

meiopagamento

text

[pt] Meio de pagamento.

tinyerp_notas_detalhes_marcadores

Marcadores da nota fiscal para categorização.

Campo Tipo

nota_id

text

[pt] Identificador da nota fiscal pai.

    Notas fiscais: detalhes > > id

id

text

[pt] Identificador do marcador.

descricao

text

[pt] Descrição do marcador.

Ordens de compra

Escopos necessários no aplicativo do Olist Tiny: Ordem de Compra (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos
  • Janela passada (dias): Quantos dias para tras a partir do savepoint as ordens de compra continuarao sendo atualizadas
  • Janela futura (dias): Quantos dias para frente buscar ordens de compra com data futura

Relacionamentos:

Listagem de ordens de compra com situação, datas, totais, contato, categoria e nota fiscal vinculada.

Campo Tipo

id

text

[pt] Identificador da ordem de compra.

numero

text

[pt] Número da ordem de compra.

situacao

text

[pt] Situação atual da ordem de compra.

data

date

[pt] Data da ordem de compra.

dataprevista

text

[pt] Data prevista de entrega.

desconto

text

[pt] Desconto aplicado na ordem.

frete

float

[pt] Valor do frete.

freteporconta

text

[pt] Responsável pelo custo do frete.

totalprodutos

float

[pt] Valor total dos produtos.

totalpedidocompra

float

[pt] Valor total da ordem de compra.

observacoes

text

[pt] Observações gerais sobre a ordem.

observacoesinternas

text

[pt] Observações internas sobre a ordem.

contato_id

text

[pt] Identificador do contato do fornecedor.

    Contatos > > id

contato_nome

text

[pt] Nome do contato do fornecedor.

contato_cpfcnpj

text

[pt] CPF ou CNPJ do fornecedor.

categoria_id

text

[pt] Identificador da categoria.

categoria_descricao

text

[pt] Descrição da categoria.

notafiscal_id

text

[pt] Identificador da nota fiscal vinculada.

notafiscal_numero

text

[pt] Número da nota fiscal vinculada.

notafiscal_dataemissao

text

[pt] Data de emissão da nota fiscal.

notafiscal_natureza

text

[pt] Natureza da operação da nota fiscal.

notafiscal_valor

text

[pt] Valor total da nota fiscal.

Ordens de compra: detalhes

Escopos necessários no aplicativo do Olist Tiny: Ordem de Compra (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos
  • Incluir marcadores?: Se deseja incluir uma tabela com os marcadores de cada ordem de compra. Cada ordem passa a exigir uma leitura extra na Tiny, então a integração fica mais lenta.
  • Janela passada (dias): Quantos dias para tras a partir do savepoint as ordens de compra continuarao sendo atualizadas
  • Janela futura (dias): Quantos dias para frente buscar ordens de compra com data futura

Relacionamentos:

Objeto principal

Detalhes da ordem de compra com situação, datas, totais, contato, categoria, nota fiscal, itens e parcelas. Inclui também todos os campos da integração "Ordens de compra", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador da ordem de compra.

    Ordens de compra > > id

numero

text

[pt] Número da ordem de compra.

situacao

text

[pt] Situação atual da ordem de compra.

data

date

[pt] Data da ordem de compra.

dataprevista

text

[pt] Data prevista de entrega.

desconto

text

[pt] Desconto aplicado na ordem.

frete

float

[pt] Valor do frete.

freteporconta

text

[pt] Responsável pelo custo do frete.

totalprodutos

float

[pt] Valor total dos produtos.

totalpedidocompra

float

[pt] Valor total da ordem de compra.

observacoes

text

[pt] Observações gerais sobre a ordem.

observacoesinternas

text

[pt] Observações internas sobre a ordem.

contato_id

text

[pt] Identificador do contato do fornecedor.

    Contatos > > id

contato_nome

text

[pt] Nome do contato do fornecedor.

contato_cpfcnpj

text

[pt] CPF ou CNPJ do fornecedor.

categoria_id

text

[pt] Identificador da categoria de receita/despesa.

    Categorias: receitas e despesas > > id

categoria_descricao

text

[pt] Descrição da categoria.

notafiscal_id

text

[pt] Identificador da nota fiscal vinculada.

notafiscal_numero

text

[pt] Número da nota fiscal vinculada.

notafiscal_dataemissao

text

[pt] Data de emissão da nota fiscal.

notafiscal_natureza

text

[pt] Natureza da operação da nota fiscal.

notafiscal_valor

text

[pt] Valor total da nota fiscal.

tinyerp_ordem_compra_detalhes_itens

Itens de uma ordem de compra.

Campo Tipo

ordem_compra_id

text

[pt] Identificador da ordem de compra pai.

    Ordens de compra: detalhes > > id

produto_id

text

[pt] Identificador do produto.

    Produtos > > id

produto_sku

text

[pt] Código SKU do produto.

produto_descricao

text

[pt] Descrição do produto.

produto_tipo

text

[pt] Tipo do produto.

quantidade

float

[pt] Quantidade pedida.

preco

float

[pt] Preço unitário.

ipi

float

[pt] Valor do imposto IPI.

gtin

text

[pt] Código GTIN (código de barras).

tinyerp_ordem_compra_detalhes_parcelas

Parcelas de uma ordem de compra.

Campo Tipo

ordem_compra_id

text

[pt] Identificador da ordem de compra pai.

    Ordens de compra: detalhes > > id

id

text

[pt] Identificador da parcela.

numero

text

[pt] Número da parcela.

dias

text

[pt] Dias até o vencimento.

datavencimento

text

[pt] Data de vencimento da parcela.

valor

float

[pt] Valor da parcela.

meiopagamento

text

[pt] Meio de pagamento da parcela.

observacoes

text

[pt] Observações sobre a parcela.

tinyerp_ordem_compra_detalhes_marcadores

Marcadores da ordem de compra, para categorização. Só é criada quando a opção "Incluir marcadores?" está ativada na configuração da integração, porque aí cada ordem exige uma leitura extra.

Campo Tipo

ordem_compra_id

text

[pt] Identificador da ordem de compra pai.

    Ordens de compra: detalhes > > id

descricao

text

[pt] Descrição do marcador.

Ordens de servico

Escopos necessários no aplicativo do Olist Tiny: Ordem de Serviço (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Listagem de ordens de serviço com situação, datas, valor e cliente.

Campo Tipo

id

text

[pt] Identificador da ordem de serviço.

situacao

text

[pt] Situação atual da ordem de serviço.

numeroordemservico

text

[pt] Número da ordem de serviço.

data

date

[pt] Data da ordem de serviço.

dataprevista

text

[pt] Data prevista de conclusão.

valor

float

[pt] Valor total da ordem de serviço.

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente.

Ordens de servico: detalhes

Escopos necessários no aplicativo do Olist Tiny: Ordem de Serviço (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Incluir marcadores?: Se deseja incluir uma tabela com os marcadores de cada ordem de serviço. Cada ordem passa a exigir uma leitura extra na Tiny, então a integração fica mais lenta.
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Objeto principal

Detalhes da ordem de serviço com situação, datas, totais, equipamento, contato, vendedor, categoria e forma de recebimento. Inclui também todos os campos da integração "Ordens de serviço", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador da ordem de serviço.

    Ordens de servico > > id

situacao

text

[pt] Situação atual da ordem de serviço.

numeroordemservico

text

[pt] Número da ordem de serviço.

data

date

[pt] Data da ordem de serviço.

dataprevista

text

[pt] Data prevista de conclusão.

dataconclusao

text

[pt] Data de conclusão efetiva.

totalservicos

text

[pt] Valor total dos serviços.

totalpecas

text

[pt] Valor total das peças.

totalordemservico

text

[pt] Valor total da ordem de serviço.

equipamento

text

[pt] Nome ou descrição do equipamento.

equipamentoserie

text

[pt] Número de série do equipamento.

descricaoproblema

text

[pt] Descrição do problema relatado pelo cliente.

observacoes

text

[pt] Observações gerais sobre a ordem de serviço.

observacoesinternas

text

[pt] Observações internas sobre a ordem de serviço.

observacoesservico

text

[pt] Observações específicas do serviço.

orcar

text

[pt] Indica se a ordem requer orçamento.

orcado

text

[pt] Indica se a ordem foi orçada.

desconto

text

[pt] Desconto aplicado na ordem de serviço.

alqcomissao

float

[pt] Percentual da alíquota de comissão.

vlrcomissao

float

[pt] Valor da comissão.

tecnico

text

[pt] Nome do técnico responsável.

idforma

text

[pt] Identificador da forma de pagamento.

idcontacontabil

text

[pt] Identificador da conta contábil.

idlistapreco

text

[pt] Identificador da lista de preços.

iddeposito

text

[pt] Identificador do depósito.

    Depositos > > id

idlocalprestacao

text

[pt] Identificador do local de prestação do serviço.

contato_id

text

[pt] Identificador do contato do cliente.

    Contatos > > id

contato_nome

text

[pt] Nome do contato do cliente.

contato_cpfcnpj

text

[pt] CPF ou CNPJ do cliente.

vendedor_id

text

[pt] Identificador do vendedor.

    Vendedores > > id

vendedor_nome

text

[pt] Nome do vendedor.

categoria_id

text

[pt] Identificador da categoria de receita/despesa.

    Categorias: receitas e despesas > > id

categoria_descricao

text

[pt] Descrição da categoria.

formarecebimento_id

text

[pt] Identificador da forma de recebimento.

    Formas de recebimento > > id

formarecebimento_descricao

text

[pt] Descrição da forma de recebimento.

valor

float

[pt] Valor total da ordem de serviço.

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente.

tinyerp_ordem_servico_detalhes_marcadores

Marcadores da ordem de serviço, para categorização. Só é criada quando a opção "Incluir marcadores?" está ativada na configuração da integração, porque aí cada ordem exige uma leitura extra.

Campo Tipo

ordem_servico_id

text

[pt] Identificador da ordem de serviço pai.

    Ordens de servico: detalhes > > id

descricao

text

[pt] Descrição do marcador.

Pedidos

Escopos necessários no aplicativo do Olist Tiny: Pedidos (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Listagem de pedidos com cliente, vendedor, transportador e dados de e-commerce.

Campo Tipo

id

text

[pt] Identificador único do pedido.

situacao

text

[pt] Situação do pedido, entregue como código numérico: 0 = Aberta, 1 = Faturada, 2 = Cancelada, 3 = Aprovada, 4 = Preparando Envio, 5 = Enviada, 6 = Entregue, 7 = Pronto Envio, 8 = Dados Incompletos, 9 = Nao Entregue.

numeropedido

text

[pt] Número do pedido.

ecommerce_id

text

[pt] Identificador da plataforma de e-commerce.

ecommerce_nome

text

[pt] Nome da plataforma de e-commerce.

ecommerce_numeropedidoecommerce

text

[pt] Número do pedido na plataforma de e-commerce.

ecommerce_numeropedidocanalvenda

text

[pt] Número do pedido no canal de venda.

ecommerce_canalvenda

text

[pt] Nome do canal de venda.

datacriacao

date

[pt] Data de criação do pedido.

dataprevista

text

[pt] Data prevista de entrega.

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente.

cliente_tipopessoa

text

[pt] Tipo de pessoa do cliente (física ou jurídica).

cliente_email

text

[pt] Endereço de e-mail do cliente.

valor

float

[pt] Valor total do pedido.

vendedor_id

text

[pt] Identificador do vendedor.

    Vendedores > > id

vendedor_nome

text

[pt] Nome do vendedor.

transportador_id

text

[pt] Identificador do transportador.

transportador_nome

text

[pt] Nome do transportador.

transportador_codigorastreamento

text

[pt] Código de rastreamento do transportador.

transportador_freteporconta

text

[pt] Responsável pelo custo do frete.

origempedido

text

[pt] Origem do pedido.

Pedidos: detalhes

Escopos necessários no aplicativo do Olist Tiny: Pedidos (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Incluir marcadores?: Se deseja incluir uma tabela com os marcadores de cada pedido. Cada pedido passa a exigir uma leitura extra na Tiny, então a integração fica mais lenta.
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Objeto principal

Detalhes do pedido com cliente, vendedor, transportador, e-commerce, intermediário, endereço de entrega, itens e parcelas. Os marcadores só são replicados quando a opção "Incluir marcadores?" está ativada na configuração da integração. Inclui também todos os campos da integração "Pedidos", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador único do pedido.

    Pedidos > > id

situacao

text

[pt] Situação do pedido, entregue como código numérico: 0 = Aberta, 1 = Faturada, 2 = Cancelada, 3 = Aprovada, 4 = Preparando Envio, 5 = Enviada, 6 = Entregue, 7 = Pronto Envio, 8 = Dados Incompletos, 9 = Nao Entregue.

numeropedido

text

[pt] Número do pedido.

data

date

[pt] Data do pedido.

dataprevista

text

[pt] Data prevista de entrega.

dataentrega

text

[pt] Data de entrega realizada.

dataenvio

text

[pt] Data de envio.

datafaturamento

text

[pt] Data de faturamento.

observacoes

text

[pt] Observações do pedido.

observacoesinternas

text

[pt] Observações internas.

numeroordemcompra

text

[pt] Número da ordem de compra.

origempedido

text

[pt] Origem do pedido.

valortotalpedido

float

[pt] Valor total do pedido.

valortotalprodutos

float

[pt] Valor total dos produtos.

valordesconto

float

[pt] Valor do desconto.

valorfrete

float

[pt] Valor do frete.

valoroutrasdespesas

float

[pt] Valor de outras despesas.

idnotafiscal

text

[pt] Identificador da nota fiscal relacionada.

    Notas fiscais > > id

cliente_id

text

[pt] Identificador do cliente.

    Contatos > > id

cliente_nome

text

[pt] Nome do cliente.

cliente_cpfcnpj

text

[pt] CPF ou CNPJ do cliente.

cliente_tipopessoa

text

[pt] Tipo de pessoa do cliente (física ou jurídica).

cliente_codigo

text

[pt] Código do cliente.

cliente_email

text

[pt] Endereço de e-mail do cliente.

cliente_fantasia

text

[pt] Nome fantasia do cliente.

cliente_telefone

text

[pt] Telefone do cliente.

cliente_celular

text

[pt] Celular do cliente.

cliente_rg

text

[pt] RG do cliente.

cliente_inscricaoestadual

text

[pt] Inscrição estadual do cliente.

cliente_endereco_endereco

text

[pt] Endereço do cliente.

cliente_endereco_numero

text

[pt] Número do endereço do cliente.

cliente_endereco_complemento

text

[pt] Complemento do endereço do cliente.

cliente_endereco_bairro

text

[pt] Bairro do cliente.

cliente_endereco_municipio

text

[pt] Município do cliente.

cliente_endereco_uf

text

[pt] Estado (UF) do cliente.

cliente_endereco_cep

text

[pt] CEP do cliente.

cliente_endereco_pais

text

[pt] País do cliente.

vendedor_id

text

[pt] Identificador do vendedor.

    Vendedores > > id

vendedor_nome

text

[pt] Nome do vendedor.

ecommerce_id

text

[pt] Identificador da plataforma de e-commerce.

ecommerce_nome

text

[pt] Nome da plataforma de e-commerce.

ecommerce_numeropedidoecommerce

text

[pt] Número do pedido na plataforma de e-commerce.

ecommerce_numeropedidocanalvenda

text

[pt] Número do pedido no canal de venda.

ecommerce_canalvenda

text

[pt] Nome do canal de venda.

intermediador_id

text

[pt] Identificador do intermediário.

    Intermediadores > > id

intermediador_nome

text

[pt] Nome do intermediário.

intermediador_cnpj

text

[pt] CNPJ do intermediário.

intermediador_cnpjpagamentoinstituicao

text

[pt] CNPJ da instituição de pagamento do intermediário.

transportador_id

text

[pt] Identificador do transportador.

transportador_nome

text

[pt] Nome do transportador.

transportador_codigorastreamento

text

[pt] Código de rastreamento do transportador.

transportador_urlrastreamento

text

[pt] URL de rastreamento do transportador.

transportador_freteporconta

text

[pt] Responsável pelo custo do frete.

enderecoentrega_endereco

text

[pt] Endereço de entrega.

enderecoentrega_numero

text

[pt] Número do endereço de entrega.

enderecoentrega_complemento

text

[pt] Complemento do endereço de entrega.

enderecoentrega_bairro

text

[pt] Bairro de entrega.

enderecoentrega_municipio

text

[pt] Município de entrega.

enderecoentrega_uf

text

[pt] Estado (UF) de entrega.

enderecoentrega_cep

text

[pt] CEP de entrega.

enderecoentrega_pais

text

[pt] País de entrega.

naturezaoperacao_id

text

[pt] Identificador da natureza da operação.

naturezaoperacao_descricao

text

[pt] Descrição da natureza da operação.

deposito_id

text

[pt] Identificador do depósito.

    Depositos > > id

deposito_nome

text

[pt] Nome do depósito.

listapreco_id

text

[pt] Identificador da lista de preços.

    Listas de precos > > id

listapreco_nome

text

[pt] Nome da lista de preços.

datacriacao

date

[pt] Data de criação do pedido.

valor

float

[pt] Valor total do pedido.

tinyerp_pedidos_detalhes_itens

Itens do pedido com detalhes do produto, quantidade e valor unitário.

Campo Tipo

pedido_id

text

[pt] Identificador do pedido pai.

    Pedidos: detalhes > > id

produto_id

text

[pt] Identificador do produto.

    Produtos > > id

produto_sku

text

[pt] Código SKU do produto.

produto_descricao

text

[pt] Descrição do produto.

produto_tipo

text

[pt] Tipo do produto.

quantidade

float

[pt] Quantidade do item.

valorunitario

float

[pt] Valor unitário.

infoadicional

text

[pt] Informação adicional do item.

tinyerp_pedidos_detalhes_parcelas

Parcelas de pagamento do pedido com datas de vencimento e valores.

Campo Tipo

pedido_id

text

[pt] Identificador do pedido pai.

    Pedidos: detalhes > > id

datavencimento

text

[pt] Data de vencimento da parcela.

valor

float

[pt] Valor da parcela.

observacoes

text

[pt] Observações da parcela.

tinyerp_pedidos_detalhes_marcadores

Marcadores do pedido para categorização (ex.: loja, canal ou tags de logística aplicadas ao pedido). Só é criada quando a opção "Incluir marcadores?" está ativada na configuração da integração, porque aí cada pedido exige uma leitura extra.

Campo Tipo

pedido_id

text

[pt] Identificador do pedido pai.

    Pedidos: detalhes > > id

descricao

text

[pt] Descrição do marcador.

Produtos

Escopos necessários no aplicativo do Olist Tiny: Produtos (acesso de Leitura)

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos

Listagem de produtos com SKU, tipo, situação, unidade, localização de estoque e preços.

Campo Tipo

id

text

[pt] Identificador único do produto.

sku

text

[pt] Código SKU do produto.

descricao

text

[pt] Descrição do produto.

tipo

text

[pt] Tipo do produto (ex.: simples, kit).

tipovariacao

text

[pt] Tipo de variação (pai, filho ou nenhum).

situacao

text

[pt] Situação do produto (ativo ou inativo).

unidade

text

[pt] Unidade de medida.

gtin

text

[pt] Código GTIN (código de barras).

datacriacao

date

[pt] Data de criação do produto.

dataalteracao

date

[pt] Data da última alteração do produto.

estoque_localizacao

text

[pt] Localização do estoque.

precos_preco

float

[pt] Preço de venda.

precos_precocusto

float

[pt] Preço de custo.

precos_precocustomedio

float

[pt] Preço de custo médio.

precos_precopromocional

float

[pt] Preço promocional.

Produtos: custos

Escopos necessários no aplicativo do Olist Tiny: Produtos (acesso de Leitura)

Tipo de replicacao: Incremental

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Histórico de custos do produto: cada registro é uma alteração de custo com data de vigência, saldos de estoque, preço de custo, custo médio e preço de venda naquela data. Um produto pode ter mais de uma alteração na mesma data.

Campo Tipo

produto_id

text

[pt] Identificador do produto.

    Produtos > > id

data

date

[pt] Data a partir da qual este custo passou a valer ("A partir de").

saldoatual

float

[pt] Saldo de estoque após a alteração.

saldoanterior

float

[pt] Saldo de estoque anterior à alteração.

impostosrecuperaveis

float

[pt] Impostos recuperáveis naquela data.

precocusto

float

[pt] Preço de custo vigente a partir desta data.

customedio

float

[pt] Custo médio vigente a partir desta data.

precovenda

float

[pt] Preço de venda vigente a partir desta data.

Produtos: detalhes

Escopos necessários no aplicativo do Olist Tiny: Produtos (acesso de Leitura)

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Parametros:

  • Savepoint: A partir de qual data os registros serao lidos
  • Incluir tags?: Se deseja incluir uma tabela com as tags de cada produto. Cada produto passa a exigir uma leitura extra na Tiny, então a integração fica mais lenta.

Relacionamentos:

Objeto principal

Detalhes do produto com categoria, marca, produto pai, preços, estoque, dimensões, tributação, SEO, variações, fornecedores e kit. Inclui também todos os campos da integração "Produtos", então basta esta integração para ter a listagem e os detalhes juntos.

Campo Tipo

id

text

[pt] Identificador único do produto.

    Produtos > > id

sku

text

[pt] Código SKU do produto.

descricao

text

[pt] Descrição do produto.

descricaocomplementar

text

[pt] Descrição complementar do produto.

tipo

text

[pt] Tipo do produto (ex.: simples, kit).

tipovariacao

text

[pt] Tipo de variação (pai, filho ou nenhum).

situacao

text

[pt] Situação do produto (ativo ou inativo).

unidade

text

[pt] Unidade de medida.

unidadeporcaixa

text

[pt] Unidades por caixa.

gtin

text

[pt] Código GTIN (código de barras).

ncm

text

[pt] Código NCM de classificação fiscal.

codigolistaservicos

text

[pt] Código da lista de serviços.

origem

text

[pt] Origem do produto (nacional ou importado).

garantia

text

[pt] Informação de garantia do produto.

observacoes

text

[pt] Observações adicionais.

categoria_id

text

[pt] Identificador da categoria do produto.

    Categorias de produtos > > id

categoria_descricao

text

[pt] Descrição da categoria do produto.

categoria_caminho

text

[pt] Caminho hierárquico completo da categoria, níveis separados por " >> " (ex.: "Cozinha >> Aéreo").

marca_id

text

[pt] Identificador da marca do produto.

    Marcas > > id

marca_nome

text

[pt] Nome da marca do produto.

produtopai_id

text

[pt] Identificador do produto pai.

produtopai_sku

text

[pt] SKU do produto pai.

produtopai_descricao

text

[pt] Descrição do produto pai.

precos_preco

float

[pt] Preço de venda.

precos_precocusto

float

[pt] Preço de custo.

precos_precocustomedio

float

[pt] Preço de custo médio.

precos_precopromocional

float

[pt] Preço promocional.

estoque_saldo

float

[pt] Saldo do estoque.

estoque_localizacao

text

[pt] Localização do estoque.

dimensoes_altura

float

[pt] Altura do produto.

dimensoes_largura

float

[pt] Largura do produto.

dimensoes_comprimento

float

[pt] Comprimento do produto.

dimensoes_diametro

float

[pt] Diâmetro do produto.

dimensoes_pesobruto

float

[pt] Peso bruto.

dimensoes_pesoliquido

float

[pt] Peso líquido.

dimensoes_quantidadevolumes

text

[pt] Quantidade de volumes.

tributacao_classeipi

text

[pt] Classe de IPI.

tributacao_gtinembalagem

text

[pt] Código GTIN da embalagem.

tributacao_valoripifixo

float

[pt] Valor fixo de IPI.

seo_titulo

text

[pt] Título para SEO.

seo_descricao

text

[pt] Descrição para SEO.

seo_slug

text

[pt] Slug da URL para SEO.

seo_linkvideo

text

[pt] Link de vídeo para SEO.

datacriacao

date

[pt] Data de criação do produto.

dataalteracao

date

[pt] Data da última alteração do produto.

tinyerp_produtos_detalhes_variacoes

Variações do produto com SKU, descrição, código de barras e preços.

Campo Tipo

produto_pai_id

text

[pt] Identificador do produto pai.

    Produtos: detalhes > > id

id

text

[pt] Identificador único da variação.

sku

text

[pt] Código SKU da variação.

descricao

text

[pt] Descrição da variação.

gtin

text

[pt] Código GTIN da variação (código de barras).

precos_preco

float

[pt] Preço de venda da variação.

precos_precocusto

float

[pt] Preço de custo da variação.

precos_precocustomedio

float

[pt] Preço de custo médio da variação.

precos_precopromocional

float

[pt] Preço promocional da variação.

tinyerp_produtos_detalhes_fornecedores

Fornecedores do produto com código do fornecedor e código do produto no fornecedor.

Campo Tipo

produto_id

text

[pt] Identificador do produto pai.

    Produtos: detalhes > > id

id

text

[pt] Identificador do fornecedor.

    Contatos > > id

nome

text

[pt] Nome do fornecedor.

codigoprodutonofornecedor

text

[pt] Código do produto no fornecedor.

tinyerp_produtos_detalhes_kit

Componentes do kit com detalhes do produto e quantidades.

Campo Tipo

produto_id

text

[pt] Identificador do produto pai (kit).

    Produtos: detalhes > > id

produto_id_kit

text

[pt] Identificador do produto componente do kit.

produto_sku

text

[pt] SKU do produto componente do kit.

produto_descricao

text

[pt] Descrição do produto componente do kit.

quantidade

float

[pt] Quantidade do componente no kit.

tinyerp_produtos_detalhes_anexos

Anexos do produto (URLs de imagens e imagens externas).

Campo Tipo

produto_id

text

[pt] Identificador do produto pai.

    Produtos: detalhes > > id

anexos_url

text

[pt] URL do anexo (imagem ou arquivo).

anexos_externo

boolean

[pt] Se o anexo é uma URL externa.

tinyerp_produtos_detalhes_tags

Tags do produto, para categorização (ex.: "OUTLET", "MIX ATUAL"), com o grupo de tags. Só é criada quando a opção "Incluir tags?" está ativada na configuração da integração, porque aí cada produto exige uma leitura extra.

Campo Tipo

produto_id

text

[pt] Identificador do produto pai.

    Produtos: detalhes > > id

tag_id

text

[pt] Identificador da tag.

    Tags > > id

nome

text

[pt] Nome da tag.

grupo_tag_id

text

[pt] Identificador do grupo de tags.

    Grupos de tags > > id

grupo_tag_nome

text

[pt] Nome do grupo de tags.

Separacao

Escopos necessários no aplicativo do Olist Tiny: Separação (acesso de Leitura)

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualizacao: Quantos dias anteriores ao savepoint os dados continuarao sendo atualizados
  • Savepoint: A partir de qual data os registros serao lidos

Relacionamentos:

Listagem de separações com situação, datas, cliente, e-commerce, forma de envio, venda e nota fiscal.

Campo Tipo

id

text

[pt] Identificador da separação.

situacao

text

[pt] Situação atual da separação.

datacriacao

date

[pt] Data de criação da separação.

dataseparacao

text

[pt] Data em que a separação foi realizada.

datacheckout

text

[pt] Data de checkout da separação.

dataemissao

text

[pt] Data de emissão da nota fiscal.

idorigemvinc

text

[pt] Identificador do registro de origem vinculado.

objorigemvinc

text

[pt] Tipo do objeto de origem vinculado.

cliente_id

text

[pt] Identificador do cliente.

cliente_nome

text

[pt] Nome do cliente.

ecommerce_id

text

[pt] Identificador da plataforma de e-commerce.

ecommerce_nome

text

[pt] Nome da plataforma de e-commerce.

ecommerce_numeropedidoecommerce

text

[pt] Número do pedido no e-commerce.

formaenvio_id

text

[pt] Identificador da forma de envio.

    Formas de envio > > id

formaenvio_descricao

text

[pt] Descrição da forma de envio.

venda_id

text

[pt] Identificador da venda vinculada.

venda_numero

text

[pt] Número da venda vinculada.

notafiscal_id

text

[pt] Identificador da nota fiscal vinculada.

notafiscal_numero

text

[pt] Número da nota fiscal vinculada.

Servicos

Escopos necessários no aplicativo do Olist Tiny: Serviços (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Listagem de serviços com código, situação, preço, unidade e classificação do serviço.

Campo Tipo

id

text

[pt] Identificador do servico.

nome

text

[pt] Nome do servico.

codigo

text

[pt] Codigo do servico.

situacao

text

[pt] Situacao do servico (ativo/inativo).

preco

float

[pt] Preco do servico.

unidade

text

[pt] Unidade de medida do servico.

nbs

text

[pt] Codigo da Nomenclatura Brasileira de Servicos (NBS).

codigolistaservicos

text

[pt] Codigo da lista de servicos (LC 116).

descricaocomplementar

text

[pt] Descricao complementar do servico.

observacoes

text

[pt] Observacoes sobre o servico.

tipoitemsped

text

[pt] Tipo do item no SPED.

Tags

Escopos necessários no aplicativo do Olist Tiny: Tags de Produtos (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Relacionamentos:

Tags com nome, nome do grupo e ID do grupo.

Campo Tipo

id

text

[pt] Identificador único da tag.

nome

text

[pt] Nome da tag.

id_grupo_tag

text

[pt] Identificador do grupo de tags ao qual esta tag pertence.

    Grupos de tags > > id

grupo

text

[pt] Nome do grupo da tag.

Usuarios

Escopos necessários no aplicativo do Olist Tiny: Usuários (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Usuários com nome, email e tipo.

Campo Tipo

id

text

[pt] Identificador do usuario.

nome

text

[pt] Nome do usuario.

email

text

[pt] Email de login do usuario.

email_comunicacao

text

[pt] Email de comunicacao do usuario.

tipo

text

[pt] Tipo do usuario.

Vendedores

Escopos necessários no aplicativo do Olist Tiny: Vendedores (acesso de Leitura)

Esta integracao e gratuita

Tipo de replicacao: Integral

Listagem de vendedores com situação e dados do contato vinculado.

Campo Tipo

id

text

[pt] Identificador do vendedor.

situacao

text

[pt] Situacao do vendedor (ativo/inativo).

contato_id

text

[pt] Identificador do contato vinculado.

contato_nome

text

[pt] Nome do contato vinculado.

contato_cpfcnpj

text

[pt] CPF ou CNPJ do contato vinculado.

contato_email

text

[pt] Email do contato vinculado.

Notas

  • Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Perguntas frequentes

O que é o conector do Olist Tiny na Kondado?
É uma integração que extrai dados do ERP Olist Tiny (antigo Tiny ERP) — pedidos, produtos, estoque, notas fiscais, contas a pagar e a receber, contatos, CRM, ordens de serviço e mais — e envia automaticamente para um Data Warehouse, Data Lake, planilha ou ferramenta de BI, centralizando suas informações para análise.
Quais destinos posso usar para os dados do Olist Tiny?
Os dados do Olist Tiny podem ser enviados para diversos destinos suportados pela Kondado, incluindo Power BI, Looker Studio, Google Sheets, Excel, BigQuery, PostgreSQL e outros. Veja a lista completa na página de destinos.
Preciso criar um aplicativo no Olist Tiny para usar o conector?
Sim. A autenticação é feita por um aplicativo de API criado na sua própria conta do Olist Tiny, informando https://app.kondado.com.br/sources/new/133 como URL de redirecionamento e marcando as permissões dos módulos que deseja utilizar. O Client ID e o Client Secret gerados são então informados na Kondado. O passo a passo completo está nas instruções desta página.
Preciso de conhecimento técnico para integrar o Olist Tiny?
Não. A Kondado é uma plataforma no-code: basta selecionar o conector, autenticar e escolher o destino, sem precisar escrever código. A configuração é feita por interface visual.
Com que frequência os dados do Olist Tiny são atualizados?
A Kondado executa a integração na frequência que você escolher (por exemplo, a cada hora ou diariamente). O agendamento é configurável dentro da integração.
A API do Olist Tiny tem limites de requisições?
Sim, a API do Olist Tiny possui limites de requisições no tempo, compartilhados por todos os aplicativos que consomem a API na sua conta. A Kondado lida com esses limites de forma transparente, mas eles podem tornar a leitura de dados um pouco mais demorada, principalmente nas integrações do tipo “detalhes”, que fazem um número maior de requisições.

Escrito por·Publicado em 2026-09-10