Oracle outbound
Oracle outbound publiceert feedback en exports vanuit ERP-NL naar Oracle EBS, Oracle Fusion of een file landing zone. De integratie is bedoeld voor gecontroleerde terugkoppeling van betaal- en reconciliatie-informatie naar een extern financieel bronsysteem.
Wat kun je met Oracle outbound?
Met Oracle outbound kun je:
- targets voor EBS, Fusion of bestandslanding beheren;
- exporttypen per target activeren;
- authenticatie en retrybeleid configureren;
- outbound events monitoren;
- mislukte events opnieuw aanbieden;
- events annuleren wanneer ze niet meer verwerkt moeten worden;
- een worker-run handmatig starten voor operationele opvolging.
Schermen
| Scherm | Route | Doel |
|---|---|---|
| Oracle outbound inrichting | /setup/banking/oracle-outbound | Targets beheren |
| Oracle outbound monitoring | /monitoring/integrations/oracle-outbound | Events, statussen en payloaddetails opvolgen |
Targets
Een target beschrijft waar ERP-NL outbound feedback naartoe publiceert.
| Veld | Betekenis |
|---|---|
| Target code | Interne code, bijvoorbeeld ORACLE_EBS_NL1 |
| Target type | EBS of FUSION |
| Delivery mode | HTTP-service, Fusion integratie, EBS custom service, file landing zone of mock |
| Base URL / transport location | Doeladres of bestandslocatie |
| Auth type | Geen auth, API key, basic auth of OAuth |
| Secret reference | Verwijzing naar secretconfiguratie |
| Retry policy | Pogingen, vertraging en backoff |
| Enabled export types | Welke exports via het target lopen |
Eventstatussen
| Status | Betekenis |
|---|---|
PENDING | Klaar voor verzending |
SENDING | Wordt verwerkt |
DELIVERED | Succesvol afgeleverd |
FAILED_RETRYABLE | Fout, opnieuw proberen mogelijk |
FAILED_PERMANENT | Fout zonder automatische retry |
CANCELLED | Handmatig geannuleerd |
Operationeel proces
mermaid
flowchart LR
Source[Bronproces] --> Enqueue[Outbound event]
Enqueue --> Worker[Worker]
Worker --> Adapter[Adapter]
Adapter --> Oracle[Oracle of landing zone]
Adapter --> Status[Status en response]
Status --> Retry[Retry of cancel]Adapters
ERP-NL ondersteunt meerdere delivery adapters:
- HTTP adapter voor generieke servicecalls;
- EBS custom service adapter;
- Fusion ERP integration adapter;
- file landing zone adapter;
- mock adapter voor tests en lokale ontwikkeling.
Monitoring en opvolging
Gebruik de monitoringtab om:
- statusaantallen binnen de geladen selectie van maximaal 100 events te zien;
- te filteren op status en exporttype;
- payload en response te inspecteren;
- retry uit te voeren op retryable events;
- events te annuleren wanneer verdere verwerking ongewenst is;
- een worker-run te starten bij operationele achterstand.
De filters staan bij de eventtabel en worden op mobiel gebundeld in een filterpaneel. Klik op een rij om de eventdetails te openen. Tabelkolommen, kolombreedtes, compacte rijen en tekstafbreking zijn via de tabelinstellingen aanpasbaar.
Beheeradvies
- Richt eerst een mock of file landing zone in voordat productie-HTTP wordt gebruikt.
- Gebruik idempotency keys om dubbele verwerking in Oracle te voorkomen.
- Leg secrets buiten de database vast en verwijs via
secret_ref. - Controleer retrybeleid per target; niet elke fout hoort eindeloos opnieuw geprobeerd te worden.
- Monitor permanent failed events dagelijks in productieomgevingen.
API's
| Endpoint | Gebruik |
|---|---|
GET /api/oracle-outbound/targets | Targets lezen |
POST /api/oracle-outbound/targets | Target maken |
PUT /api/oracle-outbound/targets/{target_id} | Target wijzigen |
GET /api/oracle-outbound/events | Events lezen |
POST /api/oracle-outbound/events/{event_id}/retry | Event opnieuw aanbieden |
POST /api/oracle-outbound/events/{event_id}/cancel | Event annuleren |
POST /api/oracle-outbound/worker/run | Worker handmatig uitvoeren |