Journal

The Billing Journal object is linked to an authorization and is created by vendors from the available raw data from their services.

Field	Type	Description
id	string	Unique journal identifier. Note that no nesting exists for this identifier. Example: BJO-1234-5678
name	string	Name of the journal. Example: 29 Nov 2024 #1
externalId	string	External identifier or reference number. This is an optional value to assist vendors in matching the journal with external ERP systems. Example: bill-12345609
notes	string	Journal notes added by vendor during creation of a journal. Example: This is new billing data for November.
status	JournalStatus enum	State machine of the journal. Example: Accepted
vendor	Account	Reference to the vendor account object that was completed during the creation of a journal. Example: { "id": "ACC-1234-1234", "name": "Microsoft", "icon": "/static/ACC-1234-1234/account.png" }
product	Product	Reference to the Product object. Example: { "id": "PRD-1111-1111-1111", "name": "Microsoft Office 365 NCE", "icon": "/static/PRD-1111-1111-1111/logo.png" }
authorization	Authorization	Reference to the Authorization object. Example: { "id": "AUT-1234-4567", "name": "Salesforce Enterprise License" }
dueDate	DateTime	The due date of a journal. Possible values are generated according to Authorization. Example: 2024-12-29T09:09:30.087Z
currency	string	The currency of the journal. Example: EUR
assignee	User	Reference to the User object. Example: { "id": "USR-1234-1234-1234", "name": "John Smith", "icon": "/static/users/USR-1234-1234-1234.icon.svg" }
audit	AuditObject	Audit object with these possible entries: Created or Updated. Example: { "created": { "at": "...", "by": { } }, "updated": { "at": "...", "by": { } } }
price	PriceSummary	The price summary including the aggregated price values for all journal charges. Note that not all fields are visible to all actors. Example: { "totalPP": 229.8, "markup": 0.5013, "margin": 0.3339, "totalSP": 356.7 }
upload	JournalUploadSummary	Journal upload summary, including the total charges and counts of split, ready, and error charges. Only visible to SoftwareOne Operations and Vendor accounts. Example: { "total": 150, "split": 4, "ready": 144, "error": 6 }
processing	ProcessingSummary	The journal processing summary including the total charges and counts of ready, error, split, cancelled, and completed charges. Only visible to SoftwareOne Operations. Example: { "total": 150, "ready": 140, "error": 6, "split": 4, "cancelled": 2, "completed": 0 }

PriceSummary

Field	Type	Description
totalPP	decimal	A sum of all purchase price values of all charges in the billing object. Only visible to SoftwareOne Operations and Vendor accounts. Example: 229.8
markup	decimal	Average markup value among all charges in the billing object. Only visible to SoftwareOne Operations. Example: 0.5013
margin	decimal	Average margin value among all charges in the billing object. Only visible to SoftwareOne Operations. Example: 0.3339
totalSP	decimal	A sum of all the selling price values of all charges in the billing object. Only visible to SoftwareOne Operations and Vendor accounts. Example: 356.7

JournalUploadSummary

Field	Type	Description
total	integer	Number of charges in the billing object. Example: 150
split	integer	Number of split charges. Example: 4
ready	integer	Number of ready charges. Example: 144
error	integer	Number of error charges. Example: 6

ProcessingSummary

Field	Type	Description
total	integer	Total number of charges in the billing object. Example: 150
ready	integer	Number of ready charges. Example: 140
error	integer	Number of error charges. Example: 6
split	integer	Number of split charges. Example: 4
cancelled	integer	Number of cancelled charges. Example: 2
completed	integer	Number of completed charges. Example: 0

Example

JOURNAL OBJECT

{
    "id": "BJO-1234-5678",
    "name": "29 Nov 2024 #1",
    "externalId": "bill-12345609",
    "notes": "This is new billing data for November",
    "status": "Accepted",
    "vendor": {
        "id": "ACC-1234-1234",
        "name": "Microsoft",
        "icon": "/static/ACC1234-1234/account.png"
    },
    "product": {
        "id": "PRD-1111-1111-1111",
        "name": "Microsoft Office 365 NCE",
        "icon": "/static/PRD1111-1111-1111/logo.png"
    },
    "authorization": {
        "id": "AUT-1234-4567",
        "name": "Salesforce Enterprise License"
    },
    "dueDate": "2024-12-29T09:09:30.087Z",
    "currency": "EUR",
    "assignee": {
        "id": "USR-1234-1234-1234",
        "name": "John Smith",
        "icon": "/static/users/USR-1234-1234-1234.icon.svg"
    },
    "audit": {
        "created": {
            "at": "...",
            "by": {}
        },
        "updated": {
            "at": "...",
            "by": {}
        }
    },
    "priceSummary": {
        "totalPP": 229.8,
        "markup": 0.5013,
        "margin": 0.3339,
        "totalSP": 356.7
    },
    "uploadSummary": {
        "total": 150,
        "split": 4,
        "ready": 144,
        "error": 6
    },
    "processingSummary": {
        "total": 150,
        "ready": 140,
        "error": 6,
        "split": 4,
        "cancelled": 2,
        "completed": 0
    }
}