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	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

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:

• aantallen pending, delivered, retryable en permanent failed 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.

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