Get Journal Charge

Retrieves a specific charge by its ID.

get
Path parameters
idstringRequired

The ID of the charge.

journalIdstringRequired
Query parameters
selectstringOptional

The select statement to filter the fields.

Responses
200
OK
application/json
get
GET /public/v1/billing/journals/{journalId}/charges/{id} HTTP/1.1
Host: api.platform.softwareone.com
Accept: */*
{
  "$meta": {
    "omitted": [
      "text"
    ]
  },
  "id": "CHG-1234-1234-1234-1234-1234",
  "externalIds": {
    "reference": "REF-67890",
    "invoice": "INV-12345",
    "vendor": "VND-54321"
  },
  "search": {
    "subscription": {
      "criteria": "externalIds.Vendor",
      "value": "EXT-12345"
    },
    "order": {
      "criteria": "externalIds.Vendor",
      "value": "EXT-12345"
    },
    "item": {
      "criteria": "externalIds.Vendor",
      "value": "EXT-12345"
    }
  },
  "period": {
    "start": "2025-01-01T00:00:00.0000000+00:00",
    "end": "2025-01-31T23:59:59.0000000+00:00"
  },
  "quantity": 10.5,
  "price": {
    "currency": {
      "purchase": "USD",
      "sale": "EUR",
      "rate": 1
    },
    "markup": 15.5,
    "markupSource": "Line",
    "margin": 20,
    "unitPP": 100,
    "PPx1": 1000,
    "unitSP": 120,
    "SPx1": 1200
  },
  "segment": "Segment-A",
  "description": {
    "value1": "Monthly subscription charge",
    "value2": "Includes additional services"
  },
  "journal": {
    "id": "BJO-1234-1234",
    "name": "29 Nov 2024 #1",
    "dueDate": "2025-05-15T23:59:59.0000000+00:00"
  },
  "ledger": {
    "id": "BLE-1234-1234-1234-1234"
  },
  "customLedger": {
    "id": "text",
    "name": "Quarterly Revenue Ledger"
  },
  "parent": {
    "id": "CHG-1234-1234-1234-1234-1234",
    "externalIds": {
      "reference": "REF-67890",
      "invoice": "INV-12345",
      "vendor": "VND-54321"
    }
  },
  "billingType": "Automated",
  "upload": {
    "status": "Ready",
    "errors": [
      "Invalid charge amount",
      "Missing buyer information"
    ]
  },
  "licensee": {
    "id": "text",
    "icon": "text",
    "name": "text",
    "externalId": "text"
  },
  "agreement": {
    "id": "text",
    "icon": "text",
    "status": "New",
    "name": "text"
  },
  "subscription": {
    "id": "text",
    "name": "text"
  },
  "order": {
    "id": "text"
  },
  "item": {
    "id": "text",
    "name": "text",
    "externalIds": {
      "vendor": "text",
      "operations": "text"
    }
  },
  "authorization": {
    "id": "text",
    "name": "text",
    "currency": "text"
  },
  "statement": {
    "id": "SOM-1234-1234-1234-1234-1234"
  },
  "statementType": "Debit",
  "processing": {
    "status": "Ready",
    "errors": [
      "Invalid charge amount",
      "Missing buyer information"
    ]
  },
  "erpData": {
    "erpCountryCode": "US",
    "defaultErpProductId": "PROD-12345",
    "defaultErpProductName": "Standard Product",
    "cdg": "CDG-001",
    "scu": "SCU-123",
    "cco": "CCO-456",
    "erpItemId": "ITEM-789"
  },
  "buyer": {
    "id": "text",
    "icon": "text",
    "name": "text"
  },
  "vendor": {
    "id": "text",
    "icon": "text",
    "type": "Client",
    "status": "Active",
    "name": "text"
  },
  "seller": {
    "id": "text",
    "icon": "text",
    "externalId": "text",
    "name": "text",
    "erpLink": {
      "id": "text",
      "audit": "[Circular Reference]",
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "icon": "text",
      "buyer": {
        "id": "text",
        "icon": "text",
        "name": "text"
      },
      "seller": {
        "0": "[",
        "1": "C",
        "2": "i",
        "3": "r",
        "4": "c",
        "5": "u",
        "6": "l",
        "7": "a",
        "8": "r",
        "9": " ",
        "10": "R",
        "11": "e",
        "12": "f",
        "13": "e",
        "14": "r",
        "15": "e",
        "16": "n",
        "17": "c",
        "18": "e",
        "19": "]"
      },
      "name": "text",
      "status": "Active",
      "note": "text",
      "externalIds": {
        "erpCompanyContact": "text",
        "erpCustomer": "text",
        "accountExternalId": "text"
      },
      "address": {
        "addressLine1": "text",
        "addressLine2": "text",
        "postCode": "text",
        "city": "text",
        "state": "text",
        "country": "text"
      }
    }
  },
  "attributes": {
    "documentNumber": "DOC-12345",
    "orderType": "PurchaseOrder",
    "externalDocumentNo": "EXT-67890",
    "externalDocumentNo2": "EXT2-54321",
    "yourReference": "CUST-REF-001"
  },
  "split": {
    "percentage": 50
  }
}

Last updated

Was this helpful?