API pública y bien documentada. El esfuerzo real está en que tu equipo BTP active una función que el sistema ya trae — no en construir algo nuevo.
Lado PIZ
- En sandbox: si tu organización aún no tiene una cuenta de prueba, pide que te creen una — es el único paso manual. Una vez adentro, ve a Mi organización → Integraciones API y genera tu
client_id/client_secretal instante, sin pedir nada más. - En producción: Integraciones API es un add-on — pide a tu contraparte comercial que lo active para tu organización. Una vez activo, la generación de credenciales es igual de inmediata desde el mismo panel.
- Guarda el
client_secrety elwebhook_secretapenas se muestran — no se vuelven a ver. - Registra tu URL de callback de facturas en el mismo panel.
- Implementa el flujo OAuth2 +
POST /purchase_requisitions.phpy la verificación de firma del webhook — ver Referencia técnica.
Lado SAP S/4HANA Cloud — enviar la SOLPED
API OData API_PURCHASEREQUISITION_2 (v4), publicada en el SAP Business Accelerator Hub, con sandbox propio para probar antes de comprometer fecha.
Lado SAP S/4HANA Cloud — recibir la factura
API_SUPPLIERINVOICE_PROCESS_SRV o el escenario asíncrono "Supplier Invoice — Create (Inbound)" — ambos crean la factura con referencia a la orden de compra.
Qué configurar de tu lado
| Qué activar en tu instancia | Dónde | Para qué |
|---|---|---|
| Communication Arrangement | Tu administración BTP (lo activa tu equipo Basis/BTP) | Habilita el "communication scenario" de compras y facturas de proveedor |
| Communication User + credenciales OAuth2 | Resultado de activar el Communication Arrangement | Autentica las llamadas entre tu sistema y las APIs anteriores |
Sugerencia
Prueba primero contra el sandbox del SAP Business Accelerator Hub antes de tocar tu instancia productiva.