Customer Type

Integration Method

API

EDI (docs coming soon!)

API Reference

Catalog

Items (coming soon!)

Inventory

Transactions

Helpers

Testing & Monitoring

Invoices

Invoices are submitted by suppliers to retailers after an Order has been completely fulfilled and closed. In general, one invoice is submitted per purchase order.

Relationships

  • BrandInvoices belong to a single Supplier.
  • RetailerInvoices belong to a single Retailer.
  • Invoice LinesInvoices can have many Invoice Lines.

Operations

Click on an Operation to view requirements, options, & examples.

GET /v1/retailers/{retailer_id}/invoices/ Get a list of Invoices
GET /v1/retailers/{retailer_id}/invoices/{id}/ Get a single Invoice
PUT /v1/retailers/{retailer_id}/invoices/{id}/acknowledge/ Acknowledge receipt

Invoice Properties

idA static id assigned by RevCascade. Can be used as the primary key in the url of other invoice-related endpoints.
retailer

The retailer that owns the purchase order and that is expected to pay the invoice.

{
  "id": 1000,
  "name": "Demo Retailer"
}
brand

The supplier that submitted the invoice.

{
  "id": 1050,
  "name": "Demo Vendor"
}
currencyThe currency of the invoice. Always 'USD' for now.
purchase_order_number The purchase order number from the Retailer's Order Management System.
invoice_numberThe invoice number from the Supplier's financial system.
terms_net_days_dueThe number of days until the invoice is due.
terms_date_dueThe due date of the invoice.
terms_discount_percentA discount offered by the supplier if the invoice is paid early.
terms_discount_daysThe number of days until the cutoff date for the discount period.
terms_discount_date_dueThe due date of the invoice in order to qualify for discount.
remit_to

The address where the invoice the invoice should be paid.

{
  "type": "residential"",
  "name1": "Demo Supplier, Inc.",
  "name2": null,
  "street1": "1332 Hermosa Ave",
  "street2": "Suite 14",
  "city": "Hermosa Beach",
  "province": "CA",
  "postal_code": "90254",
  "country": "US",
  "phone1": (310) 555-5555,
  "phone2": null,
  "fax": null,
  "email": invoices@demosupplier.com
}
subtotal The sum of all invoice lines before any charges or allowances.
charges An array of additional invoice adjustments that increase the amount due by the retailer (e.g. dropship fees, etc).
allowances An array of additional invoice adjustments that decrease the amount due by the retailer (e.g. return allowances, etc).
due_amount The total amount due.
is_acknowledged Boolean flag that indicates whether invoice has been received and acknowledged by the Retailer.
invoiced_atThe timestamp when the Invoice was received by RevCascade.
acknowledged_atThe timestamp when the Invoice was acknowledged by the Retailer. This field is null if the Invoice has not been acknowledged.
invoice_lines

An array or Invoice Line Items. Each invoice line represents a unique item from the Purchase Order.

{
  "invoice_line_number": 1,
  "variant": {
      "id": "100084",
      "brand": {
          "id": "501",
          "name": "Marla Cielo",
      },
      "name": "Contemporary Nightstand",
      "description": "Black"
      "identifier": "1234",
      "upc": "123456789456",
      "attributes": [{
          // subset of attributes
      }]
  },
  "quantity": 2,
  "price": "21.00",
}

invoice_line_number - The ordinal line number on the invoice.

variant - The exact item that was sold.

quantity - The number of items being invoiced.

price - The price that the supplier expects to be paid for the item.

Back to Top

Examples

GET /v1/retailers/invoices/ Get a list of Invoices
Optional Query String Parameters
is_acknowledged Boolean filter that returns invoices based on whether or not they have been acknowleged.

1 - show only only invoices that have been acknowledged.
0 - show invoices that have not been acknowledged.
invoiced_at_{operator} Filter invoices received by RevCascade before or after an epoch timestamp in UTC.

Please substitute {operator} with "lt" (less than),"lte" (less than or equal), "gt" (greater than), or "gte" (greater than or equal).
limit Customize the number of results return (max 250). Requests that return more records than the limit will be paginated.

Get all new invoices that have been not yet been acknowledged.

GET https://api.revcascade.com/v1/retailers/500/invoices/?is_acknowledged=0

Back to Top

GET /v1/retailers/{retailer_id}/invoices/{id}/ Get a single Invoice

Get a single invoice by its ID.

GET https://api.revcascade.com/v1/retailers/500/invoices/123645/

Back to Top

PUT /v1/retailers/{retailer_id}/invoices/{id}/acknowledge/ Acknowledge receipt

Acknowledge receipt of a new invoice.

GET https://api.revcascade.com/v1/retailers/500/invoices/123645/acknowledge/

Back to Top