Agregadores y PSPaaS
Sucursales
3min
A partir de esta especificación se podrán crear sucursales de un subcomercio o entidad dentro de la plataforma, siempre y cuando esté habilitado dicho módulo.
POST
Request
Header Parameters
x-api-key
String
required
API Key del operador
x-access-token
String
required
Access Token del Operador
x-suga-entity
String
required
ID del comercio sobre el cual se desean crear las sucursales
Body Parameters
name
String
required
Nombre de fantasía de la sucursal
reference
String
optional
Referencia única que permita identificar a la sucursal dentro del comercio. Si no se envía se generara una automáticamente. Este parámetro no puede ser editado posteriormente.
address
Object
required
Dirección de la Sucursal.
state
String
required
Provincia o Estado de la sucursal. Para Argentina se debe utilizar la clasificacion propuesta.
city
String
required
Ciudad de la Sucursal.
zipCode
String
required
Código Postal. En Argentina se debe utilizar el Código Postal Argentino ( CPA ) cuyo formato es LNNNNLLL.
email
String
optional
Email de la sucursal. Si no se envía se considera el email del comercio.
phone
String
optional
Teléfono de la sucursal. Si no se envía se considera el teléfono del comercio.
accountType
String
optional
Permite definir una cuenta bancaria o virtual para el destino de los fondos de la sucursal, en el caso que sea diferente al comercio. 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.
En caso de no utilizar referencia, es posible utilizar el siguiente método para editar una sucursal:
PUT
Request
Header Parameters
x-api-key
String
required
API Key del operador
x-access-token
String
required
Access Token del Operador
x-suga-entity
String
required
ID del comercio sobre el cual se desea editar la sucursal
Body Parameters
name
String
optional
Nombre de fantasía de la sucursal
address
Object
optional
Dirección de la Sucursal.
state
String
optional
Provincia o Estado de la sucursal. Para Argentina se debe utilizar la clasificacion propuesta.
city
String
optional
Ciudad de la Sucursal.
zipCode
String
optional
Código Postal. En Argentina se debe utilizar el Código Postal Argentino ( CPA ) cuyo formato es LNNNNLLL.
email
String
optional
Email de la sucursal. Si no se envía se considera el email del comercio.
phone
String
optional
Teléfono de la sucursal. Si no se envía se considera el teléfono del comercio.
accountType
String
optional
Permite definir una cuenta bancaria o virtual para el destino de los fondos de la sucursal, en el caso que sea diferente al comercio. 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.
Los posibles códigos de error al crear o modificar una sucursal son:
- BRANCH:INVALID_REFERENCE
- ENTITY:COUNTRY_INVALID_STATE
- ENTITY:INVALID_MCC
- ENTITY:INVALID_ZIP_CODE
- ENTITY:INVALID_ADDRESS
- ENTITY:INVALID_ACCOUNT
- NDFE -> El {branch-id} enviado no corresponde a una sucursal válida
PUT
Request
Path Params
id
String
required
ID de la sucursal que se quiere inactivar
Header Parameters
x-api-key
String
required
API Key del operador
x-access-token
String
required
Access Token del operador
x-suga-entity
String
required
ID del comercio sobre el cual se desean gestionar las sucursales
PUT
Request
Path Params
id
String
required
ID de la sucursal que se quiere reactivar
Header Parameters
x-api-key
String
required
API Key del Operador
x-access-token
String
required
Access Token del Operador
x-suga-entity
String
required
ID del comercio sobre el cual se desean gestionar las sucursales
Updated 14 Jan 2024
Did this page help you?