5 casos prácticos con el Service Layer

Localiza los clientes de la provincia

Filtramos BusinessPartners por la dirección asociada, usando el código de provincia (campo State en las direcciones del cliente):

GET /b1s/v2/BusinessPartners
    ?$select=CardCode,CardName,ShippingType
    &$filter=BPAddresses/any(a:a/State eq 'V')
    &$filter=CardType eq 'cCustomer'

Actualiza el transportista de cada cliente

El campo ShippingType apunta al código de la tabla de tipos de transporte de SAP (agencias configuradas en Administración → Definiciones → Ventas/Compras → Tipos de envío). Con el código de la nueva agencia, se actualiza cada cliente encontrado:

PATCH /b1s/v2/BusinessPartners('C20045')
{
  "ShippingType": 4
}

// Repite la llamada para cada CardCode obtenido en el paso 1

(Opcional) Aplica también al documento por defecto

Si el transportista se fija también a nivel de pedido/albarán mediante el campo TransportationCode, el mismo patrón de filtro + PATCH se aplica sobre Orders o DeliveryNotes abiertos de esos clientes.

Sube un % a toda una lista de precios

Cada línea de PriceLists contiene los artículos con su precio. Se puede leer la lista, calcular el nuevo precio en tu script y hacer PATCH de las líneas:

PATCH /b1s/v2/PriceLists(2)
{
  "PriceListsLines": [
    { "ItemCode": "A00001", "Price": 128.50 },
    { "ItemCode": "A00002", "Price": 64.90 }
  ]
}

Aplica un descuento especial a un cliente concreto

Para descuentos por cliente/artículo (lo que en SAP se ve como "Precios especiales para socios de negocio"), se usa el objeto SpecialPrices:

POST /b1s/v2/SpecialPrices
{
  "CardCode": "C20045",
  "SpecialPrices": [
    { "ItemNo": "A00001", "Discount": 12.5 }
  ]
}

Verifica el resultado antes de propagarlo

Una simple GET tras la actualización confirma que el precio ha quedado como se espera, algo mucho más rápido que navegar por pantallas del cliente SAP para revisar artículo a artículo.

Consulta el stock de un artículo por almacén

GET /b1s/v2/Items('A00001')
    ?$select=ItemName,ItemWarehouseInfoCollection

La colección ItemWarehouseInfoCollection devuelve el stock disponible en cada almacén configurado.

Genera un traspaso entre almacenes

POST /b1s/v2/StockTransfers
{
  "DocDate": "2026-08-01",
  "FromWarehouse": "ALM-CEN",
  "ToWarehouse": "ALM-VLC",
  "StockTransferLines": [
    { "ItemCode": "A00001", "Quantity": 40,
      "WarehouseCode": "ALM-VLC", "FromWarehouseCode": "ALM-CEN" }
  ]
}

Automatiza reglas de reposición

Combinando la consulta de stock mínimo con esta creación de traspasos, es posible programar un proceso que detecte roturas de stock en un almacén y genere el traspaso automáticamente desde el almacén central.

Comprueba si el cliente ya existe

GET /b1s/v2/BusinessPartners
    ?$filter=FederalTaxID eq 'B12345678'

Crea la ficha si no existe

POST /b1s/v2/BusinessPartners
{
  "CardCode": "C20099",
  "CardName": "Nueva Empresa S.L.",
  "CardType": "cCustomer",
  "FederalTaxID": "B12345678",
  "EmailAddress": "contacto@nuevaempresa.com",
  "BPAddresses": [
    { "AddressName": "Principal", "State": "V", "AddressType": "bo_ShipTo" }
  ]
}

Actualiza campos si ya existía

Si el filtro del paso 1 devuelve un resultado, en lugar de crear se hace PATCH sobre el CardCode existente — evitando duplicados, uno de los problemas más habituales al integrar SAP con webs y CRMs externos.

Recibe el pedido en tu sistema externo

Ya sea desde una web, un marketplace o un fichero EDI, tu integración traduce ese pedido al formato que espera SAP.

Crea el pedido de venta directamente en SAP

POST /b1s/v2/Orders
{
  "CardCode": "C20045",
  "DocDate": "2026-08-01",
  "DocDueDate": "2026-08-05",
  "DocumentLines": [
    { "ItemCode": "A00001", "Quantity": 5, "UnitPrice": 128.50 },
    { "ItemCode": "A00007", "Quantity": 2 }
  ]
}

Confirma y notifica

La respuesta de SAP incluye el DocEntry del pedido creado, que se puede devolver al sistema de origen (por ejemplo, para mostrar "Pedido confirmado nº 10452" al cliente) o registrar en tu propio log de integración.