Agregadores y PSPaaS
ABM de Sub-comercios
3min
Este endpoint le permitirá crear o editar un Sub-Comercio
POST
Request
Header Parameters
x-api-key
String
optional
API Key del operador
x-access-token
String
optional
Access Token del operador
Body Parameters
reference
String
required
Identificador único del Sub-Comercio. Este ID debe ser de su sistema y debe ser único.
legalName
String
required
Nombre Legal del Comercio como se encuentra registrado en el Fisco
name
String
required
Nombre Comercial
taxIdType
String
required
Tipo de Identificador Tributario. Valores Aceptados: Argentina: arg.cuit, arg.cuil, arg.dni. Chile: chl.rut. Uruguay: ury.rut. México: mex.rfc
taxId
String
required
Identificador Tributario basado en el Tipo elegido.
mcc
String
optional
Código de Categoría de Comercio o MCC. Ver sección "Cod. de Categoria de Comercios". En caso de no enviarse, se toma el por defecto en base al Código de Actividad Nacional
country
String
required
País en formato ISO 3166-1 Alpha 3. Valores Aceptados: ARG, CHL, URY, MEX
address
Object
required
Dirección del Comercio
zipCode
String
required
Código Postal. En Argentina se debe utilizar el Código Postal Argentino ( CPA ) cuyo formato es LNNNNLLL.
city
String
required
Ciudad del Comercio
state
String
required
Provincia o Estado del Comercio. Para Argentina se debe utilizar la clasificacion propuesta.
email
String
required
Email del Comercio
phone
String
required
Teléfono del Comercio
obligatedSubject
String
optional
Indica si el comercio es Sujeto Obligado. Válido para Argentina
owner
Object
required
Indica información sobre el dueño del comercio (Personas Fïsicas) o Representante Legal (Personas Jurídicas)
countryCategoryCode
String
required
Código de Actividad del comercio a nivel nacional.
secondaryCategoryCodes
Array
optional
Array con los còdigos de actividad secundarios del comercio a nivel nacional. Array de Strings
accountType
String
optional
Permite definir una cuenta bancaria o virtual para el destino de los fondos. Aplicar sólo en los casos requeridos y de forma opcional. Aplicar sólo en los casos requeridos y previa autorización de SUGA
accountNumber
String
optional
En el caso de especificar una cuenta, indica el número de cuenta de destino de los fondos.
stateTaxes
String
optional
Contiene el listado de los regímenes impositivos por provincia que están implicados en el subcomercio (IIBB en Argentina)
stateTaxesId
String
optional
Permite definir el número de inscripción en los regímenes impositivos por provincia.
user
Object
optional
Usuario que podrá utilizar la entidad
La respuesta del servicio será con el siguiente format:
Posibles códigos de error:
- SUBMERCHANT:INVALID_REFERENCE
- SUBMERCHANT:REFERENCE_NOT_FOUND
- ENTITY:TAX_ID_TYPE_INVALID
- ENTITY:COUNTRY_INVALID_STATE
- ENTITY:INVALID_COUNTRY
- ENTITY:INVALID_MCC
- ENTITY:INVALID_ZIP_CODE
- ENTITY:INVALID_ADDRESS
- ENTITY:INVALID_ACCOUNT
- ENTITY:INVALID_NAME
- ENTITY:INVALID_LEGAL_NAME
Permite transferir o cambiar el usuario de un comercio.
POST
Request
Path Params
uid
String
optional
Identificador Único del Comercio generado durante la creación
Header Parameters
x-api-key
String
optional
x-access-token
String
optional
Body Parameters
email
String
optional
Email del usuario. El mismo debe haber sido creado previamente. Si el usuario no existe será ignorada su transferencia
Permite eliminar un comercio.
DELETE
Request
Path Params
uid
String
optional
Identificador Único del Comercio generado durante la creación
Header Parameters
x-api-key
String
optional
x-access-token
String
optional
Esta API permite obtener un listado con todos los Sub-comercios dados de alta.
GET
Request
Header Parameters
x-api-key
String
optional
x-access-token
String
optional