> For the complete documentation index, see [llms.txt](https://solutions.fundraisingbox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://solutions.fundraisingbox.com/platform-solutions-integrations/salesforce-nonprofit-cloud-npc/mapping-architecture/fbox-customized-objects.md).

# Fbox Customized Objects

## Extension of the Salesforce Nonprofit Cloud Data Model

Since the standard data model of Salesforce Nonprofit Cloud does not cover all relevant business processes of a nonprofit organization, the FundraisingBox Nonprofit Cloud Managed App extends the model with FundraisingBox **Custom Objects** and **Custom Fields**.

### **FundraisingBox Custom Objects**

| FundraisingBox Custom Object        | Description                                                                                                                        |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **SEPA Mandate**                    | Created for each single and recurring SEPA direct debit donation.                                                                  |
| **Payout**                          | The Payout object reconciles batch payout details (including provider fees) and links them to the related individual transactions. |
| **FundraisingBox Connector Errors** | The Connector logs errors for transmitted records with validation issues to notify the donor service for resolution.               |

#### Select Object for more details

{% tabs %}
{% tab title="SEPA Mandate" %}

<table><thead><tr><th width="154.05078125">Label</th><th width="176.18359375">Salesforce Field</th><th>FBox Object.Field</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>SEPA Mandate Name</td><td>Name</td><td>fbMandate.referenceId</td><td>Text(80)</td><td>Corresponds to the mandate reference number</td></tr><tr><td>Status</td><td>fbox__Status__c</td><td>fbMandate.mandateStatus</td><td>Picklist</td><td>Status of the Mandate</td></tr><tr><td>Holder Name</td><td>fbox__Holder_Name__c</td><td>fbMandate.bankAccountOwner</td><td>Text(255)</td><td>Name of the account holder as entered in the donation form</td></tr><tr><td>Payment Instrument</td><td>fbox__Payment_Instrument__c</td><td></td><td>Lookup(Payment Instrument)</td><td>Link to the payment instrument in Salesforce</td></tr><tr><td>FRB Link</td><td>fbox__FRB_Link__c</td><td></td><td>URL(255)</td><td>Download link of the SEPA Mandate.</td></tr><tr><td>Date signed</td><td>fbox__Date_signed__c</td><td>fbMandate.signatureDate</td><td>Date</td><td>Date on which the SEPA Mandate becomes active (usually the creation date)</td></tr><tr><td>Mandate reference number</td><td>fbox__Mandate_ID__c</td><td>fbMandate.referenceId</td><td>Text(35)</td><td>Automatically generated and unique mandate reference number</td></tr><tr><td>Type</td><td>fbox__Type__c</td><td>fbMandate.transactionType</td><td>Picklist</td><td>Defines the type of mandate: One-time or Recurring</td></tr><tr><td>FundraisingBox Id</td><td>fbox__FundraisingBox_Id__c</td><td>fbMandate.id</td><td>Text(40)</td><td><p></p><p>ID of the FundraisingBox object</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Payout" %}

| Label                      | Salesforce Field                           | FBox Object.Field                                                              | Type                   | Description                                                                     |
| -------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------- |
| Payout Name                | Name                                       | fbPayout.fbTypeId + fbPayout.amount + fbPayout.currency + fbPayout.createdTime | Text(255)              | Name of the individual payout object                                            |
| Amount Donations Fee       | fbox\_\_Amount\_Donations\_Fee\_\_c        | fbPayout.amountDonationsFee                                                    | Number(16, 2)          | Total of the payment service fees for the disbursed donation (negative amount). |
| Amount Donations           | fbox\_\_Amount\_Donations\_\_c             | fbPayout.amountDonations                                                       | Number(16, 2)          | Total of the original donation amounts for the disbursed donation.              |
| Amount Unknown             | fbox\_\_Amount\_Unknown\_\_c               | fbPayout.amountUnknown                                                         | Number(16, 2)          | Total amount of unknown transactions within a payout.                           |
| Payout Amount              | fbox\_\_Amount\_\_c                        | fbPayout.amount                                                                | Number(16, 2)          | Total amount transferred to the organization’s account.                         |
| Currency                   | fbox\_\_Currency\_\_c                      | fbPayout.currency                                                              | Text(10)               | Currency of the amount transferred to the organization’s account.               |
| Donation Count             | fbox\_\_Donation\_Count\_\_c               | fbPayout.donations                                                             | Number(18, 0)          | Number of disbursed donations in a payout.                                      |
| External Payout Id         | fbox\_\_External\_Payout\_id\_\_c          | fbPayout.externalPayoutId                                                      | Text(255)              | ID provided by the payment service.                                             |
| Payment Provider           | fbox\_\_Payment\_Provider\_\_c             | fbPayout.fbTypeId -> Mapped                                                    | Text(255)              | Name of Payment Provider                                                        |
| Payout Created Time        | fbox\_\_Payout\_Created\_Time\_\_c         | fbPayout.createdTime                                                           | Date/Time              | Timestamp when the payout was created by the payment service.                   |
| FundraisingBox Id          | fbox\_\_FundraisingBox\_Id\_\_c            | fbPayout.Id                                                                    | Number(18, 0)          | ID of the FundraisingBox object.                                                |
| Donations and Fees RawData | fbox\_\_Donations\_and\_Fees\_RawData\_\_c |                                                                                | Long Text Area(131072) | Internal field for further processing in Salesforce.                            |
| {% endtab %}               |                                            |                                                                                |                        |                                                                                 |

{% tab title="FundraisingBox Connector Errors" %}

| Label                    | Salesforce Field                        | Type                             | Description                                                                              |
| ------------------------ | --------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- |
| Account                  | fbox\_\_Account\_\_c                    | Lookup(Account)                  | Link to the (Person or Business) account where the error occurred.                       |
| Additional Data          | fbox\_\_Additional\_Data\_\_c           | Long Text Area(131072)           | Detailed description of the error.                                                       |
| Campaign                 | fbox\_\_Campaign\_\_c                   | Lookup(Campaign)                 | Link to the fundraising campaign where the error occurred.                               |
| Connector Sync Reference | fbox\_\_Connector\_Sync\_Reference\_\_c | Text(64)                         | Unique identifier of the connector process.                                              |
| Error Code               | fbox\_\_Error\_Code\_\_c                | Text(64)                         | A code that identifies the type of error.                                                |
| Name                     | fbox\_\_Name\_\_c                       | Auto Number                      | Sequential numbering to uniquely identify an error entry.                                |
| FundraisingBoxObjectId   | fbox\_\_FundraisingBoxObjectId\_\_c     | Text(18)                         | ID of the FundraisingBox object associated with the error.                               |
| FundraisingBoxObjectId   | fbox\_\_FundraisingBoxObjectName\_\_c   | Text(255)                        | Name of the FundraisingBox object associated with the error.                             |
| Message                  | fbox\_\_Message\_\_c                    | Text(255)                        | Short description of the error. Detailed information is stored in Additional\_Data\_\_c. |
| Gift Transaction         | fbox\_\_Gift\_Transaction\_\_c          | Lookup(Transaction)              | Link to the gift transaction where the error occurred.                                   |
| Payment Instrument       | fbox\_\_Payment\_Instrument\_\_c        | Lookup(Payment Instrument)       | Link to the payment instrument where the error occurred.                                 |
| Gift Commitment          | fbox\_\_Gift\_Commitment\_\_c           | Lookup(Gift Commitment)          | Link to the gift commitment where the error occurred.                                    |
| Gift Commitment Schedule | fbox\_\_Gift\_Commitment\_Schedule\_\_c | Lookup(Gift Commitment Schedule) | Link to the gift commitment schedule where the error occurred.                           |
| Salesforce Error Message | fbox\_\_Salesforce\_Error\_Message\_\_c | Long Text Area(131072)           | The exact Salesforce error message received by the connector.                            |
| SEPA Mandate             | fbox\_\_SEPA\_Mandate\_\_c              | Lookup(SEPA Mandate)             | Link to the SEPA Mandate where the error occurred.                                       |
| {% endtab %}             |                                         |                                  |                                                                                          |
| {% endtabs %}            |                                         |                                  |                                                                                          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://solutions.fundraisingbox.com/platform-solutions-integrations/salesforce-nonprofit-cloud-npc/mapping-architecture/fbox-customized-objects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.