Vendor Invoices are available in the API once they have been cleared in FreeWheel.

Basic Attributes

The following attributes are returned by the API calls in this section.

Field NameDescriptionData Type (Length)
1. IdUnique ID for every time an invoice is cleared, unlocked, re-cleared, etc.string
2. billIdUnique ID for every time an invoice is cleared, unlocked, re-cleared, etc.integer
3. currencyCodeCurrency code (USD default)string
4. invoiceGrossCostInvoice total gross dollarsnumber
5. invoiceNetCostInvoice total net dollarsnumber
6. invoiceGrossCashInvoice gross cash dollarsnumber
7. invoiceGrossTradeInvoice gross trade valuenumber
8. totalUnitsTotal units within invoiceinteger
9. syscodeCable Vendor system code (syscode)string (5)
10. agencyIDAgency IDinteger
11. agencyNameAgency namestring (50)
12. agencyCodeOptional Agency billing codestring (50)
13. officeIDOffice IDinteger
14. officeNameOffice namestring (50)
15. officeCodeOffice billing code (Optional)string (50)
16. bottomLineInvoiceTrue/False indicating that the invoice is bottom-line and will have no invoice detail information.boolean
17. vendor
a. vendorRefIdFW unique Vendor IDinteger
b. vendorName
  • Spot: Vendor Name
  • Network: Vendor Name
  • Print/Outdoor: Publication/Vendor Name
  • Digital: Publisher/Fee Vendor Name
string (101)
c. vendorCodeVendor billing codestring (50)
d. alternateBillCodeAlternate Vendor billing codestring (30)
e. alternateBillTrue/False
If True, the alternate Vendor billing code is used for Vendor payment
boolean
f. isFeeTrue/False

True: MB Fee % is not applied to the Vendor; False: MB Fee % is applied to the Vendor
boolean
g. mediaRefIdFW media type IDinteger
h. mediaNameMedia name associated with vendor media typestring (50)
i. mediaCodeMedia type code associated with vendor media typestring (50)
18. clearedDateDate/Time Stamp when invoice was exported/cleared for paymentstring (23)
19. unlockedBillIdBill ID of related invoice when a negative/ reverse entry is created for unlocked invoicesinteger
20. matchOnNetSpot Only: Indicates whether the invoice was matched on net instead of grossboolean
21. verificationNetTrue/False: Indicates whether the Invoice Total Net Cost represents the Verification Net (true) or the Net (false) on the invoice recordboolean
22. invoiceNetTradeTotal net trade cost on invoicenumber
23. invoiceGrossInvestmentTotal gross cost on invoice identified as Investmentnumber
24. invoiceNetInvestmentTotal net cost on invoice identified as Investmentnumber
25. totalTradeUnitsNumber of units that are tradeinteger
26. invoiceTax1First tax amount on invoicenumber
27. tax1TypeTax type for invoiceTax1

Values are:

  • state
  • local
  • GST
  • PST
  • HST
  • QST
string
28. invoiceTax2Second tax amount on invoicenumber
29. tax2TypeTax type for InvoiceTax2

Values are:

  • state
  • local
  • GST
  • PST
  • HST
  • QST
string
30. tax1GLAccountGL Account associated with Tax 1string (50)
31. tax2GLAccountGL Account associated with Tax 2string (50)
32. totalAmountDueTotal amount due on invoicenumber
33. cashInAdvanceTrue/False: Indicates whether the invoice is a pre-pay (cash-in-advance) invoiceboolean
34. repBillTrue/False: Indicates whether the Rep Bill Code should be used in place of the Vendor Code or Alternate Bill Codeboolean
35. repBillCodeRep Billing Codestring (50)
36. billingMonthTypeIndicate whether the station/package/pub/ publisher/fee Vendor is billed by Broadcast Month (B), Calendar Month (C) or Fiscal (F)string (1)
37. InvoiceEstimates
a. estimateIdSystem generated estimate numberinteger
b. estimateCodeEstimate Billing code (Optional)string (50)
c. invoiceGrossCostAMOUNT OF GROSS COST BEING PAID ON ESTIMATEinteger
d. invoiceNetCostAMOUNT OF NET COST BEING PAID ON ESTIMATEinteger
e. invoiceGrossCashGROSS CASH AMOUNT BEING PAID ON ESTIMATEinteger
f. invoiceGrossTradeGROSS TRADE AMOUNT BE PAID ON ESTIMATEinteger
g. totalUnitsTOTAL INVOICE UNITS BEING PAID ON ESTIMATEinteger
h. mediaOrderIdSystem generated ID associated with the Vendor on the estimate/campaign
i. Integer
j. stationCallLetters
  • Spot: Vendor station call letters
  • Network: Package Name
  • Print/Outdoor, Digital: N/A
string (50)
k. stationBandCode
  • Spot: Vendor station band code (AM, FM, TV)
  • Network: Media type
  • Print/Outdoor, Digital: N/A
string (50)
l. clientRefIdFreeWheel client IDinteger
m. clientNameClient namestring (50)
n. clientCodeClient billing code (Optional)string (50)
o. divisionRefIdFreeWheel ID for the divisioninteger
p. divisionNameDivision Name (Optional)string (50)
q. divisionCodeDivision billing code (Optional)string (50)
r. productRefIdFreeWheel ID for the productinteger
s. productNameProduct namestring (50)
t. productCodeProduct billing code (Optional)string (50)
u. networkPackageCodeNetwork Only: Number used to identify Network packagesinteger
v. paidByClientVendor invoice paid by Clientboolean
w. invoiceDetailsInvoice Detail Line information
i. billDetailIdUnique ID for every time an invoice detail item is cleared, unlocked, re-cleared, etc.integer
ii. billIdUnique ID for every time an invoice is cleared, unlocked, re-cleared, etc.integer
iii. idUnique identifier for the invoice detail iteminteger
iv. invoiceIdUnique identifier for the invoiceinteger
v. networkSpot only: Cable network associated with detail itemstring (50)
vi. invoiceDetailDateInvoice Detail Date

  • Spot and Network: Unit date
  • Print: Insertion Date
  • Outdoor: Start date
  • Digital: Start date
string (23)
vii. invoiceDetailTimeRun time of the Unit for Spot and Network String (23)string (23)
viii. invoiceDetailEndDateInvoice Detail End Date

  • Spot and Network: N/A
  • Print: N/A
  • Outdoor: End date
  • Digital: End date
ix. invoiceDetailGrossCostGross cost of the line detailnumber
x. invoiceDetailNetCostNet cost of the line detailnumber
xi. unitLengthUnit length for the line detail for Spot and Networkinteger
xii. isciCodeSpot/Network: ISCI (commercial) ID for the adstring (50)
xiii. cashOrTradeSpot and Network by unit: C = Cash, T = Tradestring (1)
xiv. commentsInvoice line commentsstring (4000)
xv. programNameProgram for line detail for Spot and Networkstring (200)
xvi. numberOfUnitsNumber of invoice line unitsinteger
xvii. InvoiceOrderLinesOrder line detail pertaining to invoice line
a) marketNameMarket namestring (50)
b) marketCodeMarket codestring (50)
c) invoiceDetailGrossCostGross amount attributed to order lineinteger
d) invoiceDetailNetCostNet amount attributed to order lineinteger
e) lineIdUnique line ID associated with the order

Note: For Digital the line ID is unique by package or by placement line
integer
f) isPackageDigital Only: True/False used to identify if the line ID is associated with the package or placement lineboolean
g) orderLineNumberUnique line number by orderinteger
h) commissionCommission/Agency discount %number
i) netChargeNon-commissionable charge or fee associated with Vendornumber
j) daypartCodeDaypart code for the line detailstring (50)
k) rateTypeDigital Rate Typestring (50)
l) productName NetworkOnly: Product namestring (50)
m) productRefIdFreeWheel product Id
(Network Only)
integer
n) productCodeNetwork Only: Product codestring (50)
o) mediaChannelRefIdFreeWheel ID for the media channel / booking category codeinteger
p) mediaChannelNameName of the media channel / booking categorystring
q) mediachannelCodeExternal code for the media channel / booking categorystring
r) orderMonthMonth of order corresponding to matched invoice linestring
xviii. prepaidInvoiceDetail
a) amountAmount on Invoicenumber
b) invoiceNumberPrepaid Invoice Numberstring
c) invoiceDateDate of InvoiceDatetime
38. invoiceMonthinvoice month on invoicestring
39. bottomLineAdjustmentSpot only: Adjustment amount for bottom-line invoicesnumber
40. bottomLineAdjustmentIncludedSpot only: True/False – indicates if the BL adjustment amount should be included in the Vendor payment amountboolean
41. invoiceStatusInvoice statusstring (1)
42. invoiceNotesVendor Invoice commentsstring (4000)
43. invoiceIdUnique identifier for the invoiceinteger
44. invoiceNumberVendor Invoice numberstring (255)
45. invoiceDateVendor Invoice datestring (23)
46. invoiceDueDateVendor Invoice due datestring (23)