Registros de Tiendas en Lote

Descripción general

Portal Carat tiene una interfaz para registrar varias tiendas de un cliente, en lote.

Para ello, el dueño de la tienda debe enviar un archivo de importación de la tienda al equipo de servicio, siguiendo un formato determinado para que los datos de las tiendas del lote se puedan registrar de forma correcta y rápida. Las tiendas se importan solo cuando todas las tiendas pertenecen al mismo grupo.

La idea es que el desarrollador del cliente cree un programa que genere el archivo de importación siguiendo el formato presentado, ya que la generación manual de este archivo sería laboriosa y propensa a errores.

Formato de archivo de importación

ATENCIÓN : El archivo de importación debe generarse con codificación UTF-8 .

Campos predeterminados

Formato a recibir (formato por línea ):

campo1;campo2;campo3;...;campo16;<autorizadora1>;<autorizadora2>;...;<autorizadoraN>

Campo	Descripción del campo	Tamaño y formato	Obligatorio
field1	Código da Loja o merchant Id. Este valor identifica de forma única la tienda en Portal Carat. Por lo tanto, se sugiere utilizar aquí el CNPJ de la empresa, sin formatear, solo con números, para evitar conflictos de códigos entre diferentes tiendas.	<15 AN	Si
campo2	Nombre de fantasía	<250 AN (sin acento)	Si
campo3	Nombre corporativo	<250 AN (sin acento)	Si
campo4	CNPJ	<15 N	Opcional
campo5	Dirección (calle y número)	<30 AN (sin acento)	Opcional
campo6	Ciudad	<13 AN (sin acento)	Opcional
campo7	Estado	= 2 A	Opcional
campo8	Código postal sin formato (solo números)	<9 N	Opcional
campo9	Teléfono (opcional)	> 5 y <20 N	Opcional
campo10	correo electrónico (opcional)	> 5 y <20 AN	Opcional
campo11	Dominio del sitio	<50 AN (sin acento)	Opcional
campo12	URL de advertencia de estado (HTTPS)	<500 AN (sin acento)	Opcional
campo13	URL de autenticidad de transacción (HTTPS)	<500 AN (sin acento)	Opcional
campo14	URL para enviar HASH (HTTPS)	<500 AN (sin acento)	Opcional
campo15	URL de éxito	<500 AN (sin acentuar)	Opcional
campo16	URL de falla	<500 AN (sin acentuar)	Opcional
campo17	Cancelar URL	<500 AN (sin acentuar)	Opcional
authorizerN	Configuración del autorizador (consulte la sección [Campos de configuración del autorizador] (#campos-de-configuração-de-autorizadoras) a continuación.	-	Sí

Campos de configuração de autorizadoras

autorizadora1, autorizadora2, ..., autorizadoraN - Autorizadores para ser registrados en la tienda. Se pueden enviar N autorizadores. El campo authorizerN debe tener el siguiente formato:

...;campoAut1|campoAut2|campoAut3|campoAut4|campoAut5|parametro1|parametro2|...|parametroN

Campo	Descripción del campo	Tamaño y formato
campoAut1	Código de autorizador. Para comprobar los códigos de autorizador permitidos, consulte la sección [Ejemplos de autorizadores] (#exemplos-de-autorizadoras).	<5 N
campoAut2	Código de enrutamiento. Para comprobar los códigos de enrutamiento permitidos, consulte la sección [Ejemplos de enrutamiento] #exemplos-de-roteamentos).	<5 N
campoAut3	Importe mínimo por cuota en caso de pago a plazos, en céntimos (**).	<8 N
campoAut4	Cuota máxima con intereses ( \ *).	<2 N
campoAut5	Cuotas máximas sin intereses ( \ ).	<2 N
parámetro1, parámetro2, parámetroN	Parámetros del autorizador. Se pueden enviar N parámetros. Verifique la sección [Routing-parameters] (#parâmetros-dos-roteamentos) para verificar los requeridos para cada ruta.	-

( \ *) Campos utilizados solo para configurar pagos y preautorizaciones a través de la interfaz HTML.,

Ejemplo

Campo	Valor
Código de Loja	cod_loja_comp
Nome Fantasia	Loja dos Computadores
Razão Social	Loja dos Computadores LTDA.
CNPJ	11137051003444
Endereço	R. dos Computadores, 3032
Cidade	S Joao do Sul
Estado	SC
CEP	07022000
Telefone	12341234
E-mail	email@email.com
Domínio	https://dominio.com.br
URL de Aviso de status	https://dominio.com.br/avisoStatus.jsp
URL de Autenticidade	https://dominio.com.br/autenticidade.jsp
URL de Armazenamento	https://dominio.com.br/envioHash.jsp
URL de Sucesso	https://dominio.com.br/sucesso.jsp
URL de Fracasso	http://dominio.com.br/fracasso.jsp
URL de Cancelamento	https://dominio.com.br/cancelamento.jsp
AUTORIZADORAS
AUTORIZADORA 1
Autorizadora	Visa [1]
Roteamento	Cielo [1125]
Valor mínimo de cada parcela	20 reales [2000]
Parcelamento máximo com juros	5 cuotas [5]
Parcelamento máximo sem juros	5 cuotas [5]
Código de Filiação Cielo	00000001
AUTORIZADORA 2
Autorizadora	Mastercard [2]
Roteamento	Rede (Redecard) [1005]
Valor mínimo de cada parcela	10 reales [1000]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
Código de Filiação Rede (Redecard)	00000002

Resultado

cod_loja_comp;Loja dos Computadores;Loja dos Computadores LTDA.;11137051003444;R. dos Computadores,3032;S Joao do Sul;SC;07022000;12341234;email@email.com.br;https://dominio.com.br; https://dominio.com.br/avisoStatus.jsp; https://dominio.com.br/autenticidade.jsp; https://dominio.com.br/envioHash.jsp; https://dominio.com.br/sucesso.jsp;http://dominio.com.br/fracasso.jsp; https://dominio.com.br/cancelamento.jsp;1|1125|2000|5|5|00000001;2|1005|10 00|10|10|00000002

Parámetros de enrutamiento

Cada enrutamiento tiene los parámetros necesarios para que funcionen correctamente. Deben ser ingresados ​​en los campos de variables parámetro1, parámetro2, ..., parámetroN:

ATENCIÓN : Los parámetros deben enviarse en el orden en el que se describen en los ejemplos siguientes.

Cielo vía SiTef

Parámetros requeridos para el enrutamiento Cielo a través de SiTef:

• Código de filiação Cielo

Exemplo Cielo via SiTef

Campo	Valor
Autorizadora	Visa [1]
Roteamento	Cielo [1125]
Valor mínimo de cada parcela	10 reales [1000]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
Código de Filiação Cielo	00000001

...;1|1125|1000|10|10|00000001

Rede (Redecard) via SiTef

Parámetros necesários para el enrutaminto Rede (Redecard) via SiTef:

• Código de filiação Rede (Redecard)

Ejemplo Rede (Redecard) via SiTef

Campo	Valor
Autorizadora	Mastercard [2]
Roteamento	Rede (Redecard) [1005]
Valor mínimo de cada parcela	10 reales [1000]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
Código de Filiação Rede [Redecard]	00000002

...;1|1005|1000|10|10|00000002

Stone via SiTef

Parámetros necesários para el enrutamiento Stone via SiTef:

• Código de filiação Stone
• Código Stone (alfanumérico tamaño 9)

Ejemplo Stone via SiTef

Campo	Valor
Autorizadora	Visa [1]
Roteamento	Stone via SiTef [1265]
Valor mínimo de cada parcela	2,65 reales [265]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
Código de Filiação Stone	codigoFiliacaoDaLojaNaStone32Car
Código Stone	123456789

...;1|1265|265|10|10|codigoFiliacaoDaLojaNaStone32Car|123456789

BIN via SiTef

Parámetros necesários para el enrutamiento BIN via SiTef:

• Código de filiação BIN
• Terminal Virtual (alfanumérico tamaño 8)

Ejemplo BIN via SiTef

Campo	Valor
Autorizadora	Mastercard [2]
Roteamento	BIN via SiTef [1229]
Valor mínimo de cada parcela	2 reales [200]
Parcelamento máximo com juros	7 cuotas [7]
Parcelamento máximo sem juros	10 cuotas [10]
Código de Filiação BIN	12345678
Terminal Virtual	1TerVir8

...;2|1229|200|7|10|12345678|1TerVir8

Safra via SiTef

Parámetros necesários para el enrutamiento Safra via SiTef:

• Código de filiação Safra
• Número Lógico Terminal TEF (alfanumérico tamaño 8)

Ejemplo Safra via SiTef

Campo	Valor
Autorizadora	Mastercard [2]
Roteamento	Safra via SiTef [1296]
Valor mínimo de cada parcela	6 reais [600]
Parcelamento máximo com juros	6 parcelas [6]
Parcelamento máximo sem juros	11 parcelas [11]
Código de Filiação Safra	98765432
Número Lógico Terminal TEF	NoLgTe12

...;2|1296|600|6|11|98765432|NoLgTe12

Global Payments via SiTef

Parámetros necesários para el enrutamiento Global Payments via SiTef:

• Código de filiação Global Payments

Ejemplo Global Payments via SiTef

Campo	Valor
Autorizadora	Mastercard [2]
Roteamento	Safra via SiTef [1206]
Valor mínimo de cada parcela	2 reales [200]
Parcelamento máximo com juros	8 cuotas [8]
Parcelamento máximo sem juros	10 cuotas [10]
Código de Filiação Global Payments	12345678

...;2|1206|200|8|10|12345678

Getnet Lac via SiTef

Parámetros necesários para el enrutamiento Getnet Lac via SiTef:

• Código de filiação Getnet Lac
• Terminal Lógico (alfanumérico tamaño 8)

Ejemplo Getnet Lac via SiTef

Campo	Valor
Autorizadora	Visa [1]
Roteamento	Safra via SiTef [1181]
Valor mínimo de cada parcela	8 reales [800]
Parcelamento máximo com juros	11 cuotas [11]
Parcelamento máximo sem juros	12 cuotas [12]
Código de Filiação Getnet Lac	87654321
Terminal Lógico	TerLog18

...;1|1181|800|11|12|87654321|TerLog18

Stone WS

Este enrutamiento se refiere a la interfaz de comercio electrónico del adquirente Stone. Parámetros necesarios para el enrutamiento via Stone WS:

• salesAffiliationKey: alfanumérico.

ATENCIÓN : Los parámetros específicos para este enrutamiento deben enviarse en formato clave: valor.

Ejemplo Stone WS

Campo	Valor
Autorizadora	Visa [1]
Roteamento	Stone WS [409]
Valor mínimo de cada parcela	9 reales [900]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
salesAffiliationKey	chaveDeIdentificacaoDaLojaNaStone

...;1|409|900|10|10|salesAffiliationKey:chaveDeIdentificacaoDaLojaNaSt

one

Cielo EC

Este enrutamiento se refiere a la interfaz de comercio electrónico del adquirente Cielo. Parámetros necesarios para el enrutamiento a través de Cielo EC:

• merchantId: alfanumérico (tamaño < 36)
• merchantKey: alfanumérico (tamaño < 40)

ATENCIÓN : Los parámetros específicos para este enrutamiento deben enviarse en formato clave: valor.

Ejemplo Cielo EC

Campo	Valor
Autorizadora	Visa [1]
Roteamento	Cielo EC [201]
Valor mínimo de cada parcela	21 reales [2100]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
merchantId	identificacaoDaLojaNaCieloEC
merchantKey	chaveDaLojaNaCieloEC

...;1|201|2100|10|10|merchantId:identificacaoDaLojaNaCieloEC|merchantKey:chaveDaLojaNaCieloEC

e-Rede

Este enrutamiento se refiere a la interfaz de comercio electrónico del adquirente Rede. Parámetros necesarios para el enrutamiento a través de e-Rede:

• filiacao: numérico (tamanho 9)
• senha: alfanumérico (tamanho 32)

ATENCIÓN : Los parámetros específicos para este enrutamiento deben enviarse en formato clave: valor.

Ejemplo e-Rede

Campo	Valor
Autorizadora	Visa [1)]
Roteamento	e-Rede [1200]
Valor mínimo de cada parcela	13 reales [1300]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
filiacao	123456789
senha	aSenhaLojaNaERedeCom32Caracteres

...;1|1200|1300|10|10|filiacao:123456789|senha:aSenhaLojaNaERedeCom32Caracteres

Global Payments WS

Este enrutamiento se refiere a la interfaz de comercio electrónico del adquirente de Global Payments. Parámetros necesarios para el enrutamiento via Global Payments WS:

• merchantCode: numérico (tamanho 15)
• secretKey: alfanumérico (tamanho 20)
• terminal: numérico (tamanho 3)

ATENCIÓN : Los parámetros específicos para este enrutamiento deben enviarse en formato clave: valor.

Ejemplo Global Payments WS

Campo	Valor
Autorizadora	Mastercard [2]
Roteamento	Global Payments WS [408]
Valor mínimo de cada parcela	8 reales [800]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
merchantCode	123456789012345
secretKey	qwertyasdf0123456789
terminal	001

...;2|408|800|10|10| merchantCode:123456789012345|secretKey:qwertyasdf0123456789|terminal:001

Getnet WS

Esta ruta se refiere a la interfaz de comercio electrónico del adquirente de Getnet. Parámetros necesarios para el enrutamientovia Global Payments WS:

• username: alfanumérico (tamanho 20)
• password: alfanumérico (tamanho 40)
• merchantID: numérico (tamanho 10)
• terminalID: alfanumérico (tamanho 7)

ATENCIÓN : Los parámetros específicos para este enrutamiento deben enviarse en formato clave: valor.

Ejemplo Getnet WS

Campo	Valor
Autorizadora	Mastercard [2]
Roteamento	Getnet WS [407]
Valor mínimo de cada parcela	7 reales [700]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	12 cuotas [12]
username	nomeUsuarioDeAcessoG
password	senhaRelativaAoUsernameAcimaComQuarenta
merchantID	1234567890
terminalID	1234567

...;2|407|700|10|12|username:nomeUsuarioDeAcessoG|password:senhaRelativaAoUsernameAcimaComQuarenta|merchantID:123456790|terminalID:1234567

Ejemplos completos de líneas de archivos

A continuación, enumeraremos algunos ejemplos de líneas de archivos de importación.

Solo un autorizador

Campo	Valor
Código Loja	cod_loja_comp
Nome Fantasia	Loja dos Computadores
Razão Social	Loja dos Computadores LTDA.
CNPJ	11137051003444
Endereço	R. dos Computadores, 3032
Cidade	S Joao do Sul
Estado	SC
CEP	07022000
Telefone	12341234
E-mail	email@email.com
Domínio	https://dominio.com.br
URL de Aviso de status	https://dominio.com.br/avisoStatus.jsp
URL de Autenticidade	https://dominio.com.br/autenticidade.jsp
URL de Armazenamento	https://dominio.com.br/envioHash.jsp
URL de Sucesso	https://dominio.com.br/sucesso.jsp
URL de Fracasso	http://dominio.com.br/fracasso.jsp
URL de Cancelamento	https://dominio.com.br/cancelamento.jsp
AUTORIZADORA
Autorizadora	Visa [1]
Roteamento	Cielo [1125]
Valor mínimo de cada parcela	20 reales [2000]
Parcelamento máximo com juros	5 cuotas [5]
Parcelamento máximo sem juros	5 cuotas [5]
Código de Filiação Cielo	00000001

cod_loja_comp;Loja dos Computadores;Loja dos ComputadoresLTDA.;11137051003444;R. dos Computadores,3032;S Joao doSul;SC;07022000;12341234;email@email.com.br;https://dominio.com.br;https://dominio.com.br/avisoStatus.jsp;https://dominio.com.br/autenticidade.jsp;https://dominio.com.br/envioHash.jsp;https://dominio.com.br/sucesso.jsp;http://dominio.com.br/fracasso.jsp;https://dominio.com.br/cancelamento.jsp;1|1125|2000|5|5|00000001

Duas autorizadoras

Campo	Valor
Código Loja	cod_loja_comp
Nome Fantasia	Loja dos Computadores
Razão Social	Loja dos Computadores LTDA.
CNPJ	11137051003444
Endereço	R. dos Computadores, 3032
Cidade	S Joao do Sul
Estado	SC
CEP	07022000
Telefone	12341234
E-mail	email@email.com
Domínio	https://dominio.com.br
URL de Aviso de status	https://dominio.com.br/avisoStatus.jsp
URL de Autenticidade	https://dominio.com.br/autenticidade.jsp
URL de Armazenamento	https://dominio.com.br/envioHash.jsp
URL de Sucesso	https://dominio.com.br/sucesso.jsp
URL de Fracasso	http://dominio.com.br/fracasso.jsp
URL de Cancelamento	https://dominio.com.br/cancelamento.jsp
AUTORIZADORAS
AUTORIZADORA 1
Autorizadora	Visa [1]
Roteamento	Cielo [1125]
Valor mínimo de cada parcela	20 reales [2000]
Parcelamento máximo com juros	5 cuotas [5]
Parcelamento máximo sem juros	5 cuotas [5]
Código de Filiação Cielo	00000001
AUTORIZADORA 2
Autorizadora	Mastercard [2]
Roteamento	Stone WS [409]
Valor mínimo de cada parcela	10 reales [1000]
Parcelamento máximo com juros	10 cuotas [10]
Parcelamento máximo sem juros	10 cuotas [10]
salesAffiliationKey	chaveDeIdentificacaoDaLojaNaStone

cod_loja_comp;Loja dos Computadores;Loja dos ComputadoresLTDA.;11137051003444;R. dos Computadores,3032;S Joao doSul;SC;07022000;12341234;email@email.com.br;https://dominio.com.br;https://dominio.com.br/avisoStatus.jsp;https://dominio.com.br/autenticidade.jsp;https://dominio.com.br/envioHash.jsp;https://dominio.com.br/sucesso.jsp;http://dominio.com.br/fracasso.jsp;https://dominio.com.br/cancelamento.jsp;1|1125|2000|5|5|00000001;2|405|1000|10|10|salesAffiliationKey :chaveDeIdentificacaoDaLojaNaStone

Ejemplos de autorizadores

A continuación se enumeran los autorizadores que se pueden enviar al momento de la importación: | Autorizadora | Código | | ----------------------------- | ------ | | Visa | 1 | | Mastercard | 2 | | Amex | 3 | | Hipercard / Hiper | 5 | | Aura | 6 | | Diners | 33 | | Elo | 41 | | JCB | 43 | | Discover | 44 | | Visa Electron | 221 | | Maestro / Mastercard débito | 286 |

Ejemplos de enrutamiento

A continuación se enumeran las rutas que se pueden enviar en la importación:

Autorizadora	Código
Cielo	1125
Rede (Redecard)	1005
Stone WS	409
Cielo EC	201
e-Rede	1200
Global Payments WS	408
Getnet WS	407