Developers

General

Wallet

Cobro

Comercio

QR estático

Botón simple

Botón simple 2.0

Recaudación por transferencia

Deuda

Liquidador

Consultas transacciones

Webhooks

Archivos

Onboarding

Agente de cobros

COBRO

>

Comercio

Crear sucursal

Da de alta una nueva sucursal en el comercio indicado.

La sucursal es una subdivisión "física" de un comercio. Dentro de una sucursal puede haber n cajas. Un comercio puede tener muchas cajas distribuidas en distintas sucursales.

Dependiendo de tu caso de uso, es posible que no necesites integrar esta funcionalidad, ya que podes utilizar valores fijos a crear una única vez manualmente.

Endpoint

POST

/bindentidad-comercio-v2/v2/api/v1.201/comercios/{id}/sucursales

Request

Path Parameters

id string
— REQUIRED
Es el código del comercio en donde se desea crear la sucursal.

Body

calle string
— REQUIRED
Calle y altura del domicilio en donde se encuentra localizada la sucursal.

piso string
— OPTIONAL
Piso del domicilio en donde se encuentra localizada la sucursal.

departamento string
— OPTIONAL
Departamento del domicilio en donde se encuentra localizada la sucursal.

nombre string
— REQUIRED
Nombre o denominación de la sucursal.

codigoProvincia int
— REQUIRED
Id de provincia. Consultar provincias.

codigoLocalidad int
— OPTIONAL
Id de localidad. Consultar localidades.

email string
— REQUIRED
Correo electrónico de la sucursal.

telefono string
— REQUIRED
Número telefónico de la sucursal.

telefonoSecundario string
— OPTIONAL
Número telefónico secundario de la sucursal.

codigoPostal string
— REQUIRED
Código postal argentino del domicilio en donde se encuentra localizada la sucursal.

caja[] object
— REQUIRED
Objeto con información de la caja que se creará por defecto en la sucursal.
Es requerido enviar este objeto, aunque puede tener su contenido vacío en caso de no querer crear una caja por defecto.

nombre string
— OPTIONAL
Nombre o denominación de la caja.

soloOrden boolean
— REQUIRED
Indica si la caja acepta cobros sin ordenes de venta.
Valores permitidos:
true = Sólo acepta cobros si tiene una orden de venta creada.
false = Acepta cobros por más que no haya una orden de venta creada.

tipoCajaId int
— REQUIRED
Indica si la caja acepta cobros sin ordenes de venta.
Valores permitidos:
1 = Caja para cobro presente (físico en punto de venta).
2 = Caja para cobro no presente (e-commerce, email, web, factura, cupón, etc).

curl request

Copy code

curl -v -X POST "https://gw-staging-qrbind.epays.services/bindentidad-comercio-v2/v2/api/v1.201/comercios/C07663/sucursales" -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IlQxU3QtZExUdnlXUmd4Ql82NzZ1OGtyWFMtSSJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3MDA2MDExOTcsIm5iZiI6MTcwMDYwMTE5NywiZXhwIjoxNzAwNjA1MDk3LCJhaW8iOiJFMlZnWUxqc3JuV1F1VjVnKzd5Rlc5Kyt5LzdVb0craVpSQlI4RnpIeUtYNWN0cVVoQ0FBIiwiYXpwIjoiMWVlZDNmMWQtZjY1Ny00NmI0LTg3MzYtYTcyYjFiNWUxYjc1IiwiYXpwYWNyIjoiMSIsIm9pZCI6IjEyMGJkMTQzLTY2YmYtNDU5Mi1hM2NlLWI3ZDA1MmUzYTlkNiIsInJoIjoiMC5BWDBBaVZ2dllmT05uVW1NRXpqLTFkQ2NjaXVSMWJZMFRySlBuekVuRS1FSzkwV2FBQUEuIiwicm9sZXMiOlsiR3JvdXAuRW50aXRpZXMiLCJYLUNsaWVudE5hbWUuUUEtMDUiLCJYLUVudGlkYWQuWiJdLCJzdWIiOiIxMjBiZDE0My02NmJmLTQ1OTItYTNjZS1iN2QwNTJlM2E5ZDYiLCJ0aWQiOiI2MWVmNWI4OS04ZGYzLTQ5OWQtOGMxMy0zOGZlZDVkMDljNzIiLCJ1dGkiOiI3WFloenJhMkFFV1ctc2M3WldfeEFBIiwidmVyIjoiMi4wIn0.nqcCLEr4GjVSfhQgicuAGct2SIotKR-fCbTeuDca8ntrJmWcymvRlUNzYXM5PD_MW6YvnInWgE7FkuIoW343XDKax_e-IPfadj5qHfuQ4FWxcX6NRJOSsE-MZx0gYnEW-H0w3ej4saVf2c2Dm3RiP2aaPzvZzxatd9jcQzGissGLUOW_o8wur_Ks_r4UmimGvRQBXsWkdgA4JeKbcrVq9jCUeKN3zXZ7kKQ0MMiLiQUn3drmVMgrzHP2XVDHaJTrjKPiDYorKx5Mr0ngymDpl3y71PHChKAbPxsdTg0hpUMKd8zZhWk4z8eXsjg76bzlBjAi_R5GiDENOeGMvho7Ug" --data-raw "{
    \"calle\": \"Siempreviva 742\",
    \"piso\": \"\",
    \"departamento\": \"\",
    \"nombre\": \"Sucursal de prueba\",
    \"codigoProvincia\": 1,
    \"codigoLocalidad\": 247,
    \"email\": \"sucursal@deprueba.com\",
    \"telefono\": \"116666666\",
    \"telefonoSecundario\": \"\",
    \"codigoPostal\": \"1414\",
    \"caja\": [{
    \"nombre\": \"Caja por defecto en sucursal de prueba\",
    \"soloOrden\": true,
    \"tipoCajaId\": 2
    }]
}"

Response

id string
Es el código de la sucursal que se acaba de crear.

HTTP 200

Creación exitosa

HTTP 200

Creación exitosa

HTTP 422

Provincia incorrecta

HTTP 422

Provincia incorrecta

HTTP 400

Falta algún campo requerido

HTTP 400

Falta algún campo requerido

HTTP 422

Comercio inválido

HTTP 422

Comercio inválido

HTTP 401

Token de autenticación inválido

HTTP 401

Token de autenticación inválido

Changelog

17/09/2024 - El campo localidad deja de ser obligatorio.