Rappi - Formato do arquivo de

integrações
Formato de envio
Atualmente o arquivo deve ser disponibilizado em formato CSV ou TSV em um de nossos servidores
SFTP.

Delimitadores (apenas para arquivo CSV)

Mesmo o arquivo sendo padronizado como CSV, o mesmo pode utilizar diferentes demilitadores de
coluna, como por exemplo "," ou ";" (preferencialmente este) ou até mesmo "|".

Valores (quote e unquote)

Os valores das colunas podem ou não estar entre aspas (quote values). Caso esteja utilizando "quote
values" e seja necessário adicionar aspas em algum texto, deve ser utilizado o padrão duplas aspas
para escapar estas aspas.
Exemplos (ambos são aceitos, porém apenas 3 colunas não é um modelo válido):
simples.csv
123;Texto simples;Outro texto com "aspas"; Valor;...
quoted_values.csv
"123";"Texto simples";"Outro texto com ""aspas"""; "Valor";...

Caracter de quebra de linha

Muito cuidado com o caracter de quebra de linhas \n. Caso o mesmo exista em algum texto, pode
quebrar o formato do csv. O caracter de quebra de linha deve estar presente apenas no final da
linha.
O padrão utilizado para quebra de linha dever ser UNIX (LF), e não windows (CRLF).

Cabeçalho (Header)
A primeira linha deve ser sempre o cabeçalho "header" do arquivo. Ele será utilizado para
identificarmos as colunas que estão sendo enviadas no arquivo, uma vez que nem todas são
obrigatórias.

Codificação de caracteres acentuados

Deve ser utilizado o padrão UTF-8 (padrão universal) para evitar problemas com acentuação de
caracteres.
 Padrão para nomenclatura do arquivo
Cada loja deve ser enviada em um arquivo separado.
Existem 3 principais modelos que podem ser utilizados:

Seguindo um dos seguintes padrões de nomenclatura:

Data + Hora: IDLOJA_YYYY-MM-DDTHHmm.csv ou IDLOJA_YYYY-MM-DDTHHmm.tsv
Apenas Data: IDLOJA_YYYY-MM-DD.csv
Unix Timestamp: IDLOJA_UNIXTS.csv

Onde:

IDLOJA Identificador da loja. Caso numérico,

preferencialmente iniciando com zeros a esquerda
YYYY Ano completo

MM Mês com caracteres, ex:

DD Dia com caracteres, ex:

T Separador de data para hora

HH Horário em hrs

mm Minutos

Exemplo
1 Loja 123, ficaria: 123_2018-06-22T1537.csv
2 ou
3 Loja 123, ficaria: 123_1530765419.csv
O horário pode ser UTC ou local, não sendo tão relevante desde que exista consistência desde o
primeiro envio. O horário é apenas utilizado para separarmos os arquivos quando existe mais de 1
envio por dia.

GTIN (EAN)
Para nós, o código GTIN é muito importante para a identificação rápida do produto (identificação
automática e não manual).
Como alguns produtos não possuem este código (ex.: produtos de fabricação própria, pesáveis, etc),
o mesmo pode ficar em branco, porém apenas para estes casos específicos.
Apenas 1 EAN por SKU é importante, porém, caso seja necessário o envio de mais de um EAN para
o mesmo SKU (caso de atualização de embalagem, etc), o produto deve ter seu id duplicado
seguindo o exemplo abaixo…

1 1;78900001;Produto A;123.50;...
2 2;78900002;Produto B;10.50;...
3 2;78900022;Produto B;10.50;...
4 2;78900045;Produto B;10.50;...

Colunas do arquivo

Coluna Obrigatória Descrição

store_id sim Identificador único da loja do

lado do parceiro. O mesmo de
ser númerico.
id sim Este é o id do produto no
parceiro. O mesmo é utilizado
principalmente para a
identificação de produtos que
não possuem EAN. Pode ser
numérico mais comum ou
string, desde que seja único para
a identificação de cada SKU.
gtin não Para o Brasil, seria o código EAN
do produto. Está coluna é muito
importante, porém como nem
todos produtos possuem o
mesmo, ela pode ser vazia.
name sim Nome do produto que será
exibido no site.
description não Descrição que é exibida
juntamente com o código do
produto.
brand não É a marca do produto.

trademark sim É a marca de venda de um

produto. Ex: Baden baden,
Schincariol, Skol, etc.
category_first_level sim É utilizado na categorização do
produto. Primeiro nível da
categoria.
category_second_level sim Segundo nível na categorização.

price sim É o preço base do produto. Caso

o produto não possua desconto,
é o preço de venda do mesmo.
Caso exista desconto, é o preço
"De" na frase: "De R por
R ". O preço deve ser
informado em padrão
decimal , sem formatação.
 Ex: ou ou
.
discount_price não É o preço final de venda do
produto com desconto. Deve
seguir o mesmo padrão que o da
coluna "price".
discount não É o desconto que deve ser
aplicado no preço base do
produto. Caso a seja informado
para um mesmo produto o
"discount_price", esta coluna é
desconsiderada. O valor deve ser
decimal seguindo o exemplo:
ou
discount_start_at não Deve ser informando seguindo o
padrão "ISO ". Exemplos
possíveis: Normal, apenas data
será considerado o timezone SP
para o Brasil, que no caso seria o
segundo do dia : - - .
Normal com hora específica
deve ser obrigatóriamente
informado o timezone : " -
- T - ". Normal
com hora específica em formato
UTC: - - T Z.
discount_end_at não Deve seguir o mesmo modelo
que o da coluna
"discount_start_at".
stock sim É a quantidade de itens do SKU
no estoque. Caso o mesmo seja
de fabricação própria, pode ser
informado um valor " ".
Caso seja informado " ", o
produto será considerado como
indisponível. O campo pode ser
inteiro ou decimal. Ex: ou

is_available sim Deve ser informado "true" ou " "

para produtos com estoque.
"false" ou " " para produtos sem
estoque.
sale_type sim Deve ser informando se o
produto é vendido por unidade,
ou peso. Os possíveis valores
são: u: venda por unidade, w:
venda por peso gramas .
image_url não Link completo com a imagem do
produto caso exista.