Banyan Technology LIVE Connect™
  1. Invoices
Banyan Technology LIVE Connect™
  • Version 3
    • Authentication
      • Retrieve a token
    • Shipments
      • Creating
        • Create a Full Shipment
        • Create an EZ Rate Shipment
      • Updating
        • Add Document(s) to a Shipment
        • Update a Shipment
        • Adds one or more Reference Numbers to a Shipment
        • Mark as Exported
      • Retrieving
        • Get a Shipment
        • Get multiple Shipments
        • Get Quotes
        • Get Reference Numbers for a Shipment
        • Get documents for the specified shipment.
      • Booking
        • Book a Shipment
        • Unbooks the awarded quote on the specified load.
      • Canceling
        • Cancels a shipment.
    • Invoice
      • Get multiple invoices
      • Mark as Exported
    • Tracking
      • Get tracking statuses
      • Mark as exported.
    • StaticData
      • Accessorials
      • Document Types
      • Equipment Types
      • Package Types
      • Limited Access Types
      • Size UOMs
      • Weight UOMs
      • Pay Types
      • Ship Types
      • Countries
      • Statuses
      • Service Modes
    • Insurance
      • Get Vendors
  • Version 2
    • Recommended Workflow
      • Rating
        • ImportForQuote
        • ImportForQuote_Sync
        • GetQuotes
      • Booking/Dispatching
        • BookLoad
      • Tracking
        • GetTrackingStatuses
      • Documents
        • GetDocuments
      • Invoices
        • GetInvoices
          POST
        • GetInvoicesWithLoadDetails
          POST
    • Additional Offerings
      • Cancelling
        • Cancel a Load
      • Updating
        • UpdateLoad
        • UpdateLoadStatus
        • UpdateShipmentsExport
      • Importing
        • PendingImport
        • ImportForBook
      • Manual Quotes
        • AddManualQuote
      • EZ Rates
        • EzRate
        • EzRate_Sync
      • Waterfall Tendering
        • StartWaterfallTendering
        • CancelWaterfallTendering
      • Unbooking
        • UnBookLoad
      • Additional Dispatching
        • DispatchLoad
      • Load Details
        • GetLoadDetails
        • GetNotes
      • Additional Tracking
        • GetTrackingByLoad
      • Other
        • Normalized Charge Codes
      • SOAP
    • Changelog
  • Exports and Webhooks
    • Standard Load Export - v1
    • Standard Load Export - v2
    • Standard Load Export - v3
    • Push Tracking
  • Schemas
    • Schemas
      • v2
        • Enums
          • Package Type Enum
          • Freight Class Enum
          • Document Types Enum
          • Limited Access Types Enum
          • Equipment Type Enum
          • Service Code Enum
          • Size UOM Enum
          • Weight UOM Enum
          • Inco Terms Enum
          • Ship Type Enum
          • Pay Type Enum
          • Note Type Enum
          • Failure Reason Codes Enum
          • Currency Types Enum
          • Image Format Enum
          • Date Filter Types Enum
          • Invoice Status Enum
          • Load Status Enum
        • common
          • Authentication Data
          • ErrorObject
        • Invoices
          • objects
            • InvoiceBatchDetails
            • InvoiceLoadDetails
            • InvoiceQuoteDetails
            • InvoiceLineDetails
            • InvoicePaymentDetails
            • InvoiceAddressDetails
            • InvoiceDetails
          • GetInvoicesResponse
          • GetInvoicesRequest
        • Import
          • ImportAsBookedRequest
          • ImportForRatingAndPendingRequest
          • ImportAsBookedResponse
          • ImportForRatingAndPendingResponse
        • tracking
          • GetTrackingStatusesResponse
          • GetTrackingStatusesRequest
          • GetTrackingByLoadRequest
          • GetTrackingByLoadResponse
        • documents
          • objects
            • Document
          • GetDocumentsRequest
          • GetDocumentResponse
        • booking/dispatching
          • DispatchRequest
          • BookLoadRequest
          • DispatchResponse
          • BookLoadResponse
          • DispatchLoadRequest
          • DispatchLoadResponse
        • updates
          • UpdateLoadRequest
          • UpdateLoadResponse
          • UpdateLoadStatusRequest
          • UpdateLoadStatusResponse
          • UpdateShipmentExportRequest
          • UpdateShipmentExportResponse
        • quotes
          • objects
            • FailedQuote
            • PendingQuote
            • QuoteCharge
            • PriceBreakout
            • Quote
            • ManualQuote
          • AddManualQuoteRequest
          • AddManualQuoteResponse
          • GetQuotesResponse
          • GetQuotesRequest
        • ezrates
          • EZRateRequest
          • EZRateResponse
        • accessorials
          • ShipperAccessorials
          • ConsigneeAccessorials
          • LoadAccessorials
        • notes
          • GetNotesRequest
          • GetNotesResponse
        • load details
          • GetLoadDetailsRequest
          • GetLoadDetailsResponse
        • AddressInfo
        • ContactInfo
        • Dock
        • PackageInfo
        • Product
        • ParcelOptions
        • InternationalOptions
        • Shipper
        • Consignee
        • BillTo
        • Loadinfo
        • RateServices
        • ReturnLocation
        • InsuranceInfo
        • ReferenceField
        • UserDefined
        • Note
        • InsuranceDetails
        • FullLoadDetails
      • Webhooks
        • Tracking Event
      • v3
        • Enums
          • ClientDocumentTypesEnum
          • ImportStatusEnum
          • LimitedAccessEnum
          • DocumentTypesEnum
          • CurrencyEnum
          • PackageTypesEnum
          • FreightClassEnum
          • Weight UOM Enum
          • ShipTypeEnum
          • PayTypeEnum
          • ServiceModeEnum
          • EquipmentTypeEnum
          • LoadStatusEnum
          • ExportReasonsEnum
          • InternationalTermsEnum
          • ShipmentAccessorialsAbbrevEnum
          • ShipmentAccessorialsDescEnum
          • ShipperAccessorialsDescEnum
          • ShipperAccessorialsAbbrevEnum
          • ConsigneeAccessorialsAbbrevEnum
          • ConsigneeAccessorialsDescEnum
          • Size UOM Enum
          • Web Tracking codes
          • EDI Tracking Codes
        • DocumentPostDto
        • BrokerDto
        • ClientDto
        • ManualQuoteDto
        • BanyanWebServices.Domain.Dtos.CreateShipment.ShipmentDataDto
        • BanyanWebServices.Domain.Dtos.DocumentDto
        • BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto
        • BanyanWebServices.Domain.Dtos.ErrorWrapperDto
        • BanyanWebServices.Domain.Dtos.GetQuotesDto
        • AwardedQuotePricingDto
        • ContactPersonDto
        • InsuranceDetailsDto
        • QuoteChargeDto
        • QuoteDto
        • QuotePriceDto
        • BanyanWebServices.Domain.Dtos.GetShipment.UpdateShipmentResponseDto
        • BanyanWebServices.Domain.Dtos.Invoices.BatchDetailsDto
        • BanyanWebServices.Domain.Dtos.Invoices.InvoiceAddressDto
        • BanyanWebServices.Domain.Dtos.Invoices.InvoiceDto
        • BanyanWebServices.Domain.Dtos.Invoices.InvoiceLineItemDto
        • BanyanWebServices.Domain.Dtos.Invoices.PaymentDto
        • BanyanWebServices.Domain.Dtos.Invoices.QuoteDetailsDto
        • BanyanWebServices.Domain.Dtos.Invoices.ShipmentDetailsDto
        • NoteDto
        • BanyanWebServices.Domain.Dtos.Quotes.FailedQuoteDto
        • BanyanWebServices.Domain.Dtos.Quotes.PendingQuoteDto
        • ShipmentAccessorialDto
        • ShipperAccessorialDto
        • ConsigneeAccessorialDto
        • AddressDto
        • BillToDto
        • BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto
        • ContactMethodsDto
        • DimensionsDto
        • BanyanWebServices.Domain.Dtos.Shipment.DispatchResponseDto
        • DockDetailsDto
        • HandlingUnitDto
        • HazmatDetailsDto
        • BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto
        • InternationalDetailDto
        • LocationDto
        • BanyanWebServices.Domain.Dtos.Shipment.MarketRateDto
        • PackageInfoDto
        • ProductDto
        • ReferenceFieldDto
        • ShipmentServiceDto
        • StaticData.AccessorialsDto
        • TimeZoneDto
        • TrackingDto
        • TrackingStatusDto
        • BanyanWebServices.Domain.Enums.LoadStatus
        • BanyanWebServices.Domain.Enums.NoteFilter
        • BanyanWebServices.Domain.Enums.QuoteFilter
        • BanyanWebServices.Domain.Requests.BookQuoteRequest
        • BanyanWebServices.Domain.Requests.Common.IdListRequest
        • BanyanWebServices.Domain.Requests.Common.IdRequest
        • BanyanWebServices.Domain.Requests.CreateReferenceNumberRequest
        • BanyanWebServices.Domain.Requests.MarkTrackingExportedRequest
        • CreateShipmentRequest
        • GetDocumentsRequest
        • BanyanWebServices.Domain.Requests.Version3.GetInvoicesRequest
        • BanyanWebServices.Domain.Requests.Version3.GetShipmentsRequest
        • BanyanWebServices.Domain.Requests.Version3.GetTrackingByLoadRequest
        • BanyanWebServices.Domain.Requests.Version3.UpdateShipmentRequest
        • ErrorResponse
  1. Invoices

GetInvoices

POST
/services/api/rest/getInvoices
This function will return invoices.

Request

Header Params

Body Params application/json

Example
{
"AuthenticationData": {
        "Username": "username",
        "Password": "password",
        "ClientRefNum": null
    },
    "IgnoreExported": true,
    "ProNumber": "Pro",
    "BOLID": "BOL",
    "LoadId": 1234567,
    "DateFilterType": "Created",
    "StartDate": "2024-03-06",
    "EndDate": "2024-03-13",
    "InvoiceStatusFilter": "Approved"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ws.integration.banyantechnology.com/services/api/rest/getInvoices' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"AuthenticationData": {
        "Username": "username",
        "Password": "password",
        "ClientRefNum": null
    },
    "IgnoreExported": true,
    "ProNumber": "Pro",
    "BOLID": "BOL",
    "LoadId": 1234567,
    "DateFilterType": "Created",
    "StartDate": "2024-03-06",
    "EndDate": "2024-03-13",
    "InvoiceStatusFilter": "Approved"
}'

Responses

🟢200GetInvoices - 200 OK
application/json
Body

Example
{
    "Invoices": [
        {
            "ApID": 3033722,
            "InvoiceType": "AP",
            "ClientName": "Company",
            "ClientReferenceNumber": "",
            "InvoiceStatusCode": "EXP",
            "NetAmountDue": 273.75,
            "TotalCharges": 228.75,
            "Variance": 0,
            "CurrencyCode": "USD",
            "CarrierName": "Trucing Company 3",
            "CarrierSCAC": "TRUK",
            "VendorName": null,
            "VendorID": null,
            "HasException": false,
            "ShipmentCreatedFromInvoice": false,
            "CreatedDateTime": "2018-05-01T14:34:46.81",
            "BillingDateTime": "2018-05-01T00:00:00",
            "ExportedDateTime": "2018-08-10T11:44:53.59",           
            "ShipmentDetails": {
                "LoadID": 987654321,
                "GuidLoadID": "46f7-9840-1fc3ebc244a9",
                "ProNumber": "123PRO",
                "BOLID": "BOL18099",
                "CustomerPO": "test",
                "PayType": "Prepaid",
                "TotalWeight": 800,
                "TotalPieces": 1,
                "WeightUnitOfMeasure": "LBS",
                "PickupDateTime": "2018-04-10T00:00:00",
                "DeliveryDateTime": "2018-05-01T00:00:00"
            },
            "QuoteDetails": {
                "CarrierName": "R Trucking",
                "CarrierSCAC": "TRUK",
                "QuoteNumber": "10386905",
                "DateTime": "2018-04-09T06:15:56.553",
                "TotalCharge": 228.75,
                "FreightCharge": 184.33,
                "DiscountPercent": null,
                "DiscountAmount": null,
                "FuelSurcharge": 44.42,
                "Minimum": null,
                "GrossCharge": 1417.9,
                "TotalAccessorialCharges": 0,
                "TotalOtherCharges": 0,
                "Interline": false
            },
            "BatchDetails": {
                "BatchID": "05012018",
                "User": "Mike Jones",
                "DateTime": "2018-05-01T15:16:50.787"
            },
            "LineItem": [
                {
                	"CarrierChargeCode": "MISC",
                	"NormalizedChargeCode": "MISC",
                    "Description": "Total Freight Bill Cost",
                    "Quantity": 0,
                    "PackagingCode": "",
                    "Weight": 0,
                    "Charge": 228.75,
                    "FreightClass": "",
            		"Extension": "Some Text",
                    "RatedAsQuantity": 54.0050,
                    "RatedAsQualifier": "XX"
                },
                {
                	"CarrierChargeCode": "MISC",
                	"NormalizedChargeCode": "MISC",
                    "Description": "test - do not pickup",
                    "Quantity": 1,
                    "PackagingCode": "Pallets",
                    "Weight": 800,
                    "Charge": 0,
                    "FreightClass": "92.5",
            		"Extension": "Some Text",
                    "RatedAsQuantity": null,
                    "RatedAsQualifier": null
                }
            ],
            "Payment": null,
            "Address": [
                {
                    "Type": "SH",
                    "Name": "Test Origin",
                    "IDCode": null,
                    "Address1": "123 Test St",
                    "Address2": "",
                    "City": "Chicago",
                    "StateCode": "IL",
                    "PostalCode": "60606",
                    "CountryCode": "US",
                    "GLCode": null
                },
                {
                    "Type": "CN",
                    "Name": "Test Destination",
                    "IDCode": null,
                    "Address1": "456 Test St",
                    "Address2": "",
                    "City": "Austinburg",
                    "StateCode": "OH",
                    "PostalCode": "44010",
                    "CountryCode": "US",
                    "GLCode": null
                },
                {
                    "Type": "BT",
                    "Name": "Company",
                    "IDCode": null,
                    "Address1": "123 Main St.",
                    "Address2": "",
                    "City": "Cleveland",
                    "StateCode": "OH",
                    "PostalCode": "44115",
                    "CountryCode": "US",
                    "GLCode": null
                }
            ],
            "BolAvailable": null,
            "PodAvailable": null
        }
    ],
    "Success": false,
    "Error": null
}
Modified at 2024-09-16 11:42:17
Previous
GetDocuments
Next
GetInvoicesWithLoadDetails
Built with