The BillCreditMemo object

A Rutter Bill Credit Memo represents a bill credit memo issued from a vendor that can be applied against a bill. Every bill credit memo is linked to an Vendor and zero or more Bills.

Properties

idstring

The Rutter generated unique ID of the bill credit memo.

platform_idstring

The platform specific ID of the bill credit memo.

account_idstringnullable

The Rutter ID of the Account linked to the bill credit memo. Represents the account being credited.

vendor_idstringnullable

The Rutter ID of the Vendor linked to the bill credit memo.

issue_datestring

The ISO 8601 timestamp for when the bill credit memo was issued.

document_numberstring

The buyer facing document number of the bill credit memo.

remaining_amountnumber

The remaining unapplied amount of the bill credit memo.

statusenum

The status of the bill credit memo.

One ofopenpartially_paidpaidvoiddraftunknown, or submitted.
total_amountnumber

The total amount of the bill credit memo.

currency_codeenumnullable

The ISO 4217 currency code of the bill credit memo.

One ofAEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBOVBRLBSDBTNBWPBYRBZDCADCDFCHECHFCHWCLFCLPCNYCOPCOUCRCCUCCUPCVECZKDJFDKKDOPDZDEGPERNETBEURFJDFKPGBPGELGHSGIPGMDGNFGTQGYDHKDHNLHRKHTGHUFIDRILSINRIQDIRRISKJMDJODJPYKESKGSKHRKMFKPWKRWKWDKYDKZTLAKLBPLKRLRDLSLLTLLVLLYDMADMDLMGAMKDMMKMNTMOPMROMURMVRMWKMXNMXVMYRMZNNADNGNNIONOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSLLSOSSRDSSPSTDSYPSZLTHBTJSTMTTNDTOPTRYTTDTWDTZSUAHUGXUSDUSNUSSUYIUYUUYWUZSVEFVNDVUVWSTXAFXAGXAUXBAXBBXBCXBDXCDXDRXFUXOFXPDXPFXPTXTSXXXYERZAR, or ZMW.
memostringnullable

The memo of the bill credit memo

linked_billsarray

An array of Rutter IDs of BillCreditMemo Payments applied against the BillCreditMemo.

Show linked_bills attributes
line_itemsarray

An array of line items associated with the BillCreditMemo.

Show line_items attributes
created_atstringnullable

The ISO 8601 timestamp that the bill credit memo was created.

updated_atstringnullable

The ISO 8601 timestamp that the bill credit memo was last updated.

platform_dataobjectoptional

The raw platform data corresponding to the Rutter object.

Show platform_data attributes
Example BillCreditMemo Object
{
  "id": "00000000-0000-0000-0000-000000000000",
  "platform_id": "12345678",
  "account_id": "00000000-0000-0000-0000-000000000000",
  "vendor_id": "00000000-0000-0000-0000-000000000000",
  "issue_date": "2023-01-02T02:34:56.000Z",
  "document_number": "VENDCRED-1",
  "remaining_amount": 3,
  "status": "paid",
  "total_amount": 3,
  "currency_code": "USD",
  "memo": "Discount for future Rutter shirts.",
  "linked_bills": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "allocated_date": "2023-01-02T02:34:56.000Z",
      "allocated_amount": 3
    }
  ],
  "line_items": [
    {
      "account_id": "00000000-0000-0000-0000-000000000000",
      "class_id": "00000000-0000-0000-0000-000000000000",
      "customer_id": "00000000-0000-0000-0000-000000000000",
      "department_id": "00000000-0000-0000-0000-000000000000",
      "location_id": "00000000-0000-0000-0000-000000000000",
      "tax_rate_id": "00000000-0000-0000-0000-000000000000",
      "description": "A Rutter shirt.",
      "discount_amount": 0,
      "discount_percentage": 0,
      "sub_total": 12.34,
      "tax_amount": 2,
      "total_amount": 14.34,
      "item": {
        "id": "00000000-0000-0000-0000-000000000000",
        "quantity": 1,
        "unit_amount": 12.34
      }
    }
  ],
  "created_at": "2023-01-02T02:34:56.000Z",
  "updated_at": "2023-01-02T02:34:56.000Z",
  "platform_data": {
    "id": 123,
    "data": "Varies by platform"
  }
}

List Bill Credit Memos

GET /accounting/bill_credit_memos
Supported for: NetSuiteQuickBooksQuickBooks DesktopSage IntacctXero

Request Parameters

    access_tokenstringquery

    The access token of the connection.

    cursorstringoptionalquery

    The cursor to use for pagination. This value is passed in from next_cursor field in a previous request.

    expandenumoptionalquery

    Used to request inclusion of optional objects.

    Can beplatform_data.
    force_fetchenumoptionalquery

    Force a response even if the underlying connection hasn't finished the initial sync.

    One oftrue or false.
    limitintegeroptionalquery

    The limit on the number of entities returned.

    updated_at_maxintegeroptionalquery

    Unix Timestamp in milliseconds representing the maximum updated_at datetime to fetch entities from.

    updated_at_minintegeroptionalquery

    Unix Timestamp in milliseconds representing the minimum updated_at datetime to fetch entities from.

Response Body

    connectionobject
    Show connection attributes
    bill_credit_memosarray
    Show bill_credit_memos attributes
    next_cursorstringnullableoptional
Example Response Body
{
  "connection": {
    "id": "00000000-0000-0000-0000-000000000000",
    "orgId": "00000000-0000-0000-0000-000000000000",
    "platform": "NETSUITE"
  },
  "bill_credit_memos": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "platform_id": "12345678",
      "account_id": "00000000-0000-0000-0000-000000000000",
      "vendor_id": "00000000-0000-0000-0000-000000000000",
      "issue_date": "2023-01-02T02:34:56.000Z",
      "document_number": "VENDCRED-1",
      "remaining_amount": 3,
      "status": "paid",
      "total_amount": 3,
      "currency_code": "USD",
      "memo": "Discount for future Rutter shirts.",
      "linked_bills": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "allocated_date": "2023-01-02T02:34:56.000Z",
          "allocated_amount": 3
        }
      ],
      "line_items": [
        {
          "account_id": "00000000-0000-0000-0000-000000000000",
          "class_id": "00000000-0000-0000-0000-000000000000",
          "customer_id": "00000000-0000-0000-0000-000000000000",
          "department_id": "00000000-0000-0000-0000-000000000000",
          "location_id": "00000000-0000-0000-0000-000000000000",
          "tax_rate_id": "00000000-0000-0000-0000-000000000000",
          "description": "A Rutter shirt.",
          "discount_amount": 0,
          "discount_percentage": 0,
          "sub_total": 12.34,
          "tax_amount": 2,
          "total_amount": 14.34,
          "item": {
            "id": "00000000-0000-0000-0000-000000000000",
            "quantity": 1,
            "unit_amount": 12.34
          }
        }
      ],
      "created_at": "2023-01-02T02:34:56.000Z",
      "updated_at": "2023-01-02T02:34:56.000Z",
      "platform_data": {
        "id": 123,
        "data": "Varies by platform"
      }
    }
  ],
  "next_cursor": "MTY3NDgzMTk0Ml82MDY4ZDI0ZC02NGRmLTRmN2EtYTM0Ny0zN2ZmNjY5MGVmMjU="
}

Fetch a Bill Credit Memo

GET /accounting/bill_credit_memos/:id
Supported for: NetSuiteQuickBooksQuickBooks DesktopSage IntacctXero

Request Parameters

    idstringpath

    The Rutter generated unique ID of the object.

    access_tokenstringquery

    The access token of the connection.

    force_fetchenumoptionalquery

    Force a response even if the underlying connection hasn't finished the initial sync.

    One oftrue or false.

Response Body

    connectionobject
    Show connection attributes
    bill_credit_memoobject
    Show bill_credit_memo attributes
Example Response Body
{
  "connection": {
    "id": "00000000-0000-0000-0000-000000000000",
    "orgId": "00000000-0000-0000-0000-000000000000",
    "platform": "NETSUITE"
  },
  "bill_credit_memo": {
    "id": "00000000-0000-0000-0000-000000000000",
    "platform_id": "12345678",
    "account_id": "00000000-0000-0000-0000-000000000000",
    "vendor_id": "00000000-0000-0000-0000-000000000000",
    "issue_date": "2023-01-02T02:34:56.000Z",
    "document_number": "VENDCRED-1",
    "remaining_amount": 3,
    "status": "paid",
    "total_amount": 3,
    "currency_code": "USD",
    "memo": "Discount for future Rutter shirts.",
    "linked_bills": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "allocated_date": "2023-01-02T02:34:56.000Z",
        "allocated_amount": 3
      }
    ],
    "line_items": [
      {
        "account_id": "00000000-0000-0000-0000-000000000000",
        "class_id": "00000000-0000-0000-0000-000000000000",
        "customer_id": "00000000-0000-0000-0000-000000000000",
        "department_id": "00000000-0000-0000-0000-000000000000",
        "location_id": "00000000-0000-0000-0000-000000000000",
        "tax_rate_id": "00000000-0000-0000-0000-000000000000",
        "description": "A Rutter shirt.",
        "discount_amount": 0,
        "discount_percentage": 0,
        "sub_total": 12.34,
        "tax_amount": 2,
        "total_amount": 14.34,
        "item": {
          "id": "00000000-0000-0000-0000-000000000000",
          "quantity": 1,
          "unit_amount": 12.34
        }
      }
    ],
    "created_at": "2023-01-02T02:34:56.000Z",
    "updated_at": "2023-01-02T02:34:56.000Z",
    "platform_data": {
      "id": 123,
      "data": "Varies by platform"
    }
  }
}

Create a Bill Credit Memo

POST /accounting/bill_credit_memos
Supported for: NetSuiteQuickBooksQuickBooks DesktopSage IntacctXeroZoho Books

Request Parameters

    access_tokenstringquery

    The access token of the connection.

Request Body

    bill_credit_memoobject
    Show bill_credit_memo attributes

Response Body

    Any of:

    bill_credit_memoobject
    Show bill_credit_memo attributes
    async_responseobjectoptional
    Show async_response attributes
    errorsarrayoptional
    Show errors attributes
Example Request Body
{
  "bill_credit_memo": {
    "account_id": "00000000-0000-0000-0000-000000000000",
    "vendor_id": "00000000-0000-0000-0000-000000000000",
    "issue_date": "2023-01-02T02:34:56.000Z",
    "currency_code": "USD",
    "line_items": [
      {
        "account_id": "00000000-0000-0000-0000-000000000000",
        "total_amount": 12.34,
        "description": "A Rutter shirt."
      }
    ]
  }
}
Example Response Body
{
  "bill_credit_memo": {
    "id": "00000000-0000-0000-0000-000000000000",
    "platform_id": "12345678",
    "account_id": "00000000-0000-0000-0000-000000000000",
    "vendor_id": "00000000-0000-0000-0000-000000000000",
    "issue_date": "2023-01-02T02:34:56.000Z",
    "document_number": "VENDCRED-1",
    "remaining_amount": 3,
    "status": "paid",
    "total_amount": 3,
    "currency_code": "USD",
    "memo": "Discount for future Rutter shirts.",
    "linked_bills": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "allocated_date": "2023-01-02T02:34:56.000Z",
        "allocated_amount": 3
      }
    ],
    "line_items": [
      {
        "account_id": "00000000-0000-0000-0000-000000000000",
        "class_id": "00000000-0000-0000-0000-000000000000",
        "customer_id": "00000000-0000-0000-0000-000000000000",
        "department_id": "00000000-0000-0000-0000-000000000000",
        "location_id": "00000000-0000-0000-0000-000000000000",
        "tax_rate_id": "00000000-0000-0000-0000-000000000000",
        "description": "A Rutter shirt.",
        "discount_amount": 0,
        "discount_percentage": 0,
        "sub_total": 12.34,
        "tax_amount": 2,
        "total_amount": 14.34,
        "item": {
          "id": "00000000-0000-0000-0000-000000000000",
          "quantity": 1,
          "unit_amount": 12.34
        }
      }
    ],
    "created_at": "2023-01-02T02:34:56.000Z",
    "updated_at": "2023-01-02T02:34:56.000Z",
    "platform_data": {
      "id": 123,
      "data": "Varies by platform"
    }
  }
}

Create a Bill Credit Application

POST /accounting/bill_credit_applications
Supported for: NetSuiteQuickBooksXero

Request Parameters

    access_tokenstringquery

    The access token of the connection.

Request Body

    bill_credit_applicationobject
    Show bill_credit_application attributes

Response Body

    Any of:

    bill_credit_applicationobject
    Show bill_credit_application attributes
    async_responseobjectoptional
    Show async_response attributes
    errorsarrayoptional
    Show errors attributes
Example Response Body
{
  "bill_credit_application": {
    "success": true
  }
}