API Clientes SAP HANA

Retorna el total de clientes (CardType = 'C') de las sociedades indicadas. Por defecto solo clientes TPV. Con base central cuenta clientes únicos; sin ella, registros por sociedad.

Parámetros de consulta

Ejemplo de respuesta — 200

{
  "count": 4523
}

Códigos de respuesta

Guarda la ficha sólo en la base central y deja pendiente su réplica en las sociedades destino. No escribe en SAP: el proceso de sincronización la envía después por Service Layer (BusinessPartners), respetando las validaciones de SAP.

• Si isNew = true: crea el socio con CardType = cCustomer, Properties2 = tYES (HORECA) y U_GSP_SENDTPV (por defecto Y). Sin sociedades se crea en todas las activas.
• Si isNew = false: actualiza nombre, teléfono, dirección, email, RUT y U_GSP_SENDTPV. Sin sociedades se actualiza donde ya existe.
• Con sociedades se aplica sólo en esas, creando el cliente donde no exista.
• La respuesta lista las sociedades del cliente con su estado de réplica (pendiente) y la accion que hará el proceso: crear o actualizar.
• Si el envío a SAP falla, se reintenta en cada ciclo (hasta 5 veces; luego error). Ver GET /clientes/api/sync/estado.

Body (JSON)

Ejemplo — Crear cliente

POST /clientes/api/clientes/guardar HTTP/1.1
Host: netred.fzc.cl
Authorization: Bearer <tu-token>
Content-Type: application/json

{
  "cardCode": "C99999999-9",
  "cardName": "NUEVA EMPRESA S.A.",
  "phone1": "+56912345678",
  "address": "Calle Ejemplo 123, Santiago",
  "isNew": true
}

Respuesta — 201 Created

{
  "status": "created",
  "cardCode": "C99999999-9",
  "sociedades": [
    { "cardCode": "C99999999-9", "sociedad": "PRDFRUZCO", "estado": "pendiente", "accion": "crear" },
    { "cardCode": "C99999999-9", "sociedad": "PRDMBFF", "estado": "pendiente", "accion": "crear" }
  ]
}

Ejemplo — Actualizar cliente

POST /clientes/api/clientes/guardar HTTP/1.1
Host: netred.fzc.cl
Authorization: Bearer <tu-token>
Content-Type: application/json

{
  "cardCode": "C00001",
  "cardName": "EMPRESA ACTUALIZADA S.A.",
  "phone1": "+56987654321",
  "address": "Av. Nueva 456, Valparaíso",
  "isNew": false
}

Respuesta — 200 OK

{
  "status": "updated",
  "cardCode": "C00001",
  "sociedades": [
    { "cardCode": "C00001", "sociedad": "PRDFRUZCO", "estado": "pendiente", "accion": "actualizar" }
  ]
}

Códigos de respuesta

Mismo comportamiento que POST /clientes/api/clientes/guardar. Acepta el mismo body y retorna las mismas respuestas.

Retorna la definición de columnas de la tabla de clientes de una sociedad (parámetro sociedad; si se indican varias, se usa la primera). Útil para inspeccionar la estructura del esquema.

Ejemplo de respuesta — 200

[
  {
    "name": "CardCode",
    "type": "NVARCHAR",
    "length": 15,
    "nullable": "FALSE"
  },
  {
    "name": "CardName",
    "type": "NVARCHAR",
    "length": 100,
    "nullable": "TRUE"
  }
]

Códigos de respuesta

Sociedades configuradas en setup.json. Con base central incluye clientes, envíos pendientes y envíos con error por sociedad.

[
  { "schema": "PRDFRUZCO", "nombre": "FRUZCO CHILE S.A.", "activa": true,
    "clientes": 5546, "pendientes": 0, "errores": 0 }
]

Por sociedad: última marca leída (YYYYMMDDHHMMSS), si terminó la carga inicial, última ejecución y último error. Incluye los últimos 50 envíos en estado error.

Lanza un ciclo en segundo plano y responde 202 con status iniciado o en_curso. Con ?reintentarErrores=1, los envíos en error vuelven a pendiente.