ictorch/icsap

library to consume sap webservices

v0.4.0 2026-07-29 01:57 UTC

Requires

• php: >=7.4

MIT

• Ignacio Cuadra

Published on Packagist.org on 2026-07-29 02:03 UTC

README

Librería PHP para consumir servicios web de SAP (SAP RFC/HTTP clients wrapper).

Requisitos

• PHP >= 7.4
• Composer

Instalación

Instalar mediante Composer:

composer require ictorch/icsap

Uso

La fábrica SapClientFactory crea instancias de SapClient. Debe proporcionar los parámetros obligatorios: host, port, database, username y password. Si falta alguno, la fábrica lanzará una SapException indicando los campos faltantes.

Ejemplo básico:

use ictorch\icsap\SapClientFactory;

$factory = new SapClientFactory();
try {
  $client = $factory('sap.example.com', 3300, 'MYDB', 'user', 'secret');
  // usar $client...
} catch (\ictorch\icsap\SapException $e) {
  // manejar error de configuración
  $errors = $e->getJsonErrors();
  print_r($errors);
}

Notas

• SapException recibe mensaje, entrada y salida relacionadas con el error. Para validación de parámetros, la entrada contiene los valores suministrados.
• En errores de solicitudes a SAP, getJsonErrors() agrega sapRequest con la URL, método HTTP y código de estado; no incluye cabeceras ni cookies.
• Al iniciar sesión, el cliente conserva automáticamente la cookie ROUTEID enviada por SAP junto con B1SESSION. Así la sesión queda asociada al nodo que SAP eligió en ese Login; este es el comportamiento predeterminado.
• Esta librería sólo proporciona el envoltorio; configure su entorno SAP y dependencias según sea necesario.

Forzar un nodo de Service Layer

Si la infraestructura requiere usar un nodo determinado, puede forzar la ruta sin modificar la creación actual del cliente:

$client = (new SapClientFactory())($host, $port, $database, $username, $password);
$client->setFixedRouteId('.node1');

El valor forzado tiene prioridad sobre el ROUTEID que SAP devuelva durante Login. Para volver a usar el nodo indicado por la cookie de SAP (y abrir una sesión nueva), use:

$client->useLoginRouteId();

Licencia

MIT

icsap

library to consume sap service layer

Usage

// get data form sap
$sapClient = (new SapClientFactory())();
$query = http_build_query([
  '$select'=>"CardCode,CardName",
  '$filter'=>"CardType eq 'cSupplier'"
  ]);
  $response = $this->sapClient->fetch("BusinessPartners?$query", HTTP_GET, [], ["Prefer" => "odata.maxpagesize=100"]);

// put data to sap
$sapClient = (new SapClientFactory())();
try {
  $response = $this->sapClient->fetch("Items", HTTP_POST, [
    "ItemCode" => "i001",
    "ItemName" => "Item1",
    "ItemType" => "itItem"
  ]);
} catch (\SapException $e) {
  print_r($e->getJsonErrors());
}