Registrar sucursal
/api/v1/sucursalesRegistra en Falmus una sucursal que el contribuyente ya habilitó en el Padrón del SIN. No crea ni altera una sucursal fiscal ante el SIN.
X-API-KeyVer operaciones de Sucursales y puntos de venta Contrato de la operación
Registra en Falmus una sucursal que el contribuyente ya habilitó en el Padrón del SIN. No crea ni altera una sucursal fiscal ante el SIN.
Autorización y seguridad
Requiere únicamente X-API-Key con permiso sucursales.administrar. La empresa se resuelve desde la clave; no envíes Bearer, X-Tenant-ID ni Idempotency-Key.
Cuerpo
codigo es opcional. Si lo envías debe ser un código no negativo ya existente en SIN; 0 corresponde a casa matriz. Si se omite, Falmus asigna el siguiente código local disponible de forma serializada. nombre y direccion son obligatorios. ciudad es opcional. La asignación local no registra la sucursal ante el SIN.
Respuestas
201 Created crea una sucursal en estado activo. 400 identifica el campo codigo si no es un entero entre 0 y 2147483647; 409 identifica el campo cuando el código ya está registrado o se agotó la asignación correlativa. 401 indica clave inválida y 403, permiso insuficiente.
Ejemplo
Solicitud de ejemplo
{
"codigo": 1,
"nombre": "CLIENTE DE DEMOSTRACIÓN",
"direccion": "Av. Ejemplo 123",
"ciudad": "Cochabamba"
}Respuesta
Ejemplo de respuesta
application/json{
"message": "sucursal registrada correctamente",
"data": {
"id": "00000000-0000-4000-8000-000000000021",
"codigoSiat": 1,
"nombre": "Sucursal Sur",
"direccion": "Av. Ejemplo 123",
"ciudad": "Cochabamba",
"estado": "pendiente",
"esCasaMatriz": false,
"creadoEn": "2026-08-30T16:10:00-04:00",
"actualizadoEn": "2026-08-30T16:10:00-04:00"
}
}Datos ficticios; los identificadores y valores cambian en cada respuesta.