Business Partner Credit Management

This API is used to synchronise business-partner credit-management data from the Stibo STEP MDM system into SAP.

The Credit Management service exposes the following sub-entities:

Credit worthiness score & risk class
Credit accounts
Account collaterals
Credit insurance
Negative events

Request URI

Create

Update

Status codes:

Status code	Meaning
`S`	Record processed successfully
`E`	Record processed with errors

Request Structure

API field	Type	Mandatory	Description	Technical Details
`CreditMgmtBusinessPartnerElement (0..∞)`
`STIBOBusinessPartnerID`	String	N	Stibo STEP business-partner identifier.	Nillable
`SAPBusinessPartnerID`	String	N	SAP business-partner identifier (empty on create, populated on update).	Nillable
`crdtMgmtBusinessPartnerGroup`	String	N	Credit-management business-partner group.	Nillable
`creditWorthinessScoreValue`	String	N	Credit worthiness score value.	Nillable
`crdtWrthnssScoreValdtyEndDate`	String	N	Credit worthiness score validity end date.	Nillable
`crdtWorthinessScoreLastChgDate`	String	N	Credit worthiness score last change date.	Nillable
`creditRiskClass`	String	N	Credit risk class.	Nillable
`creditRiskClassLastChangeDate`	String	N	Credit risk class last change date.	Nillable
`creditCheckRule`	String	N	Credit check rule.	Nillable
`creditScoreAndLimitCalcRule`	String	N	Credit score and limit calculation rule.	Nillable
`custBusinessRelshpStartYear`	String	N	Customer business-relationship start year.	Nillable
`toCreditNotes (0..∞)`
`creditLanguage`	String	N	Credit language.	Nillable
`creditNote (0..∞)`	String Array	N	Credit note.	Nillable
`toCrdtMBPCollateralTP (0..∞)`
`creditSegment`	String	N	Credit segment.	Nillable
`crdtAcctInformationCategory`	String	N	Credit Account Information Category	Nillable
`crdtAcctInformationType`	String	N	Credit Account Information Type	Nillable
`exceptionIsCreditCheckRelevant`	Boolean	N	Exception Is Credit Check Relevant	Nillable
`addlCreditDocAmtInTransacCrcy`	String	N	Additional Credit Doc Amount In Transac Currency	Nillable
`transactionCurrency`	String	N	Transaction currency.	Nillable
`validityStartDate`	String	N	Validity start date.	Nillable
`validityEndDate`	String	N	Validity end date.	Nillable
`additionalCreditDocComment`	String	N	Additional Credit Doc Comment	Nillable
`toCrdtMBusinessPartnerTP`	String	N	To Credit M Business Partner TP	Nillable
`toCrdtMBPCreditInsuranceTP (0..∞)`
`creditSegment`	String	N	Credit segment.	Nillable
`crdtAcctInformationCategory`	String	N	Credit Account Information Category	Nillable
`crdtAcctInformationType`	String	N	Credit Account Information Type	Nillable
`exceptionIsCreditCheckRelevant`	Boolean	N	Exception Is Credit Check Relevant	Nillable
`addlCreditDocAmtInTransacCrcy`	String	N	Additional Credit Doc Amount In Transac Currency	Nillable
`transactionCurrency`	String	N	Transaction currency.	Nillable
`validityStartDate`	String	N	Validity start date.	Nillable
`validityEndDate`	String	N	Validity end date.	Nillable
`additionalCreditDocComment`	String	N	Additional Credit Doc Comment	Nillable
`toCrdtMBusinessPartnerTP`	String	N	To Credit M Business Partner TP	Nillable
`toCrdtMBPNegativeEventTP (0..∞)`
`creditSegment`	String	N	Credit segment.	Nillable
`crdtAcctInformationCategory`	String	N	Credit Account Information Category	Nillable
`crdtAcctInformationType`	String	N	Credit Account Information Type	Nillable
`validityStartDate`	String	N	Validity start date.	Nillable
`validityEndDate`	String	N	Validity end date.	Nillable
`additionalCreditDocComment`	String	N	Additional Credit Doc Comment	Nillable
`toCrdtMBusinessPartnerTP`	String	N	To Credit M Business Partner TP	Nillable
`toCreditMgmtAccountTP (0..∞)`
`creditSegment`	String	N	Credit segment.	Nillable
`businessPartnerIsCritical`	Boolean	N	Business Partner Is Critical	Nillable
`creditAccountBlockReason`	String	N	Credit Account Block Reason	Nillable
`creditAccountResubmissionDate`	String	N	Credit Account Resubmission Date	Nillable
`creditLimitAmount`	String	N	Credit Limit Amount	Nillable
`creditLimitValidityEndDate`	String	N	Credit Limit Validity End Date	Nillable
`creditLimitIsZero`	Boolean	N	Credit Limit Is Zero	Nillable
`creditLimitRequestedAmount`	String	N	Credit Limit Requested Amount	Nillable
`creditLimitReqdValidityEndDate`	String	N	Credit Limit Reqd Validity End Date	Nillable
`creditLimitRequestDate`	String	N	Credit Limit Request Date	Nillable
`creditSegmentCurrency`	String	N	Credit Segment Currency	Nillable
`toCrdtMBusinessPartnerTP`	String	N	To Credit M Business Partner TP	Nillable
`toCreditMgmtAccountTP/toCrdtMAcctCollateralTP (0..∞)`
`crdtAcctInformationCategory`	String	N	Credit Account Information Category	Nillable
`crdtAcctInformationType`	String	N	Credit Account Information Type	Nillable
`exceptionIsCreditCheckRelevant`	Boolean	N	Exception Is Credit Check Relevant	Nillable
`addlCreditDocAmtInTransacCrcy`	String	N	Additional Credit Doc Amount In Transac Currency	Nillable
`transactionCurrency`	String	N	Transaction currency.	Nillable
`validityStartDate`	String	N	Validity start date.	Nillable
`validityEndDate`	String	N	Validity end date.	Nillable
`additionalCreditDocComment`	String	N	Additional Credit Doc Comment	Nillable
`toCrdtMBusinessPartnerTP`	String	N	To Credit M Business Partner TP	Nillable
`toCreditMgmtAccountTP`	String	N	Credit-account entries.	Nillable
`additionalCreditDocSequence`	String	N	Additional Credit Doc Sequence	Nillable
`toCreditMgmtAccountTP/toCrdtMAcctCrdtInsuranceTP (0..∞)`
`crdtAcctInformationCategory`	String	N	Credit Account Information Category	Nillable
`crdtAcctInformationType`	String	N	Credit Account Information Type	Nillable
`exceptionIsCreditCheckRelevant`	Boolean	N	Exception Is Credit Check Relevant	Nillable
`addlCreditDocAmtInTransacCrcy`	String	N	Additional Credit Doc Amount In Transac Currency	Nillable
`transactionCurrency`	String	N	Transaction currency.	Nillable
`validityStartDate`	String	N	Validity start date.	Nillable
`validityEndDate`	String	N	Validity end date.	Nillable
`additionalCreditDocComment`	String	N	Additional Credit Doc Comment	Nillable
`toCrdtMBusinessPartnerTP`	String	N	To Credit M Business Partner TP	Nillable
`toCreditMgmtAccountTP`	String	N	Credit-account entries.	Nillable

Request sample

Sample request

[ { "STIBOBusinessPartnerID": "bp_2012733", "SAPBusinessPartnerID": "9100116052", "crdtMgmtBusinessPartnerGroup": "0004", "creditWorthinessScoreValue": "3", "creditRiskClass": "004", "creditCheckRule": "05", "creditScoreAndLimitCalcRule": "STANDARD", "toCreditNotes": [ { "creditLanguage": "EN", "creditNote": [ "31.10.2024 Atradius approved to increase coverage from 50K to 130K for 2025 annual review", "", "CPR003239972, CPR003238473, CPR002241351,", "CPR001933085, CPR004048371" ] }, { "creditLanguage": "IT", "creditNote": [ "@20.11.2023 Atradius approval further to 2024 budget shared by AM (decrease from 100k to 50k" ] } ], "toCreditMgmtAccountTP": [ { "creditSegment": "IT10", "creditLimitAmount": "33000", "creditSegmentCurrency": "EUR", "toCrdtMAcctCollateralTP": [ { "crdtAcctInformationCategory": "10", "crdtAcctInformationType": "03", "exceptionIsCreditCheckRelevant": true, "addlCreditDocAmtInTransacCrcy": "155000", "transactionCurrency": "EUR", "validityStartDate": null, "validityEndDate": null, "additionalCreditDocComment": "" } ] } ] } ]

Response Structure

API field	Type	Description
`CommonResponseElement (0..∞)`
`STIBOBusinessPartnerID`	String	Stibo STEP business-partner identifier, echoed from the request.
`SAPBusinessPartnerID`	String	Business-partner identifier assigned or confirmed in the target SAP system.
`statusCode`	String	Outcome of the record: "S" = success, "E" = error.
`errorMessage`	String	Error detail when the record could not be processed; empty on success.
`message`	String	Human-readable outcome message.

Response Examples

1) Success scenarios:

HTTP Status code 200 — record(s) successfully processed

[ { "STIBOBusinessPartnerID": "BP-1001", "SAPBusinessPartnerID": "0001000123", "statusCode": "S", "message": "Upsert completed successfully." } ]

2) Error scenarios:

HTTP Status code 500 — record processed with errors

[ { "STIBOBusinessPartnerID": "BP-3003", "SAPBusinessPartnerID": "0001000999", "statusCode": "E", "errorMessage": "Credit account upsert failed.", } ]

HTTP Status code 400 — invalid request

{ "statusCode": "E", "errorMessage": "Bad request" }

version 16 as of 2 days ago by Stefano.Gallo

0 Comments

Please sign in to post a comment.

Business Partner Credit Management

0 Comments

Docs Navigation