PayPal Invoicing Release Notes - Release 1.10.0

These release notes describe changes to the following the API calls in the PayPal Invoicing WSDL:

  • CreateInvoice
  • DeleteInvoice
  • SendInvoice
  • CreateandSendInvoice
  • UpdateInvoice
  • GetInvoiceDetails
  • CancelInvoice
  • SearchInvoice
  • MarkInvoiceAsPaid
  • MarkInvoiceAsRefunded
  • MarkInvoiceAsUnpaid
  • RemindInvoice

These products use the previous calls:

  • Invoicing
  • PayPal Here
  • Excel Invoicing Plug-in

Announcements

No new announcements.

API Updates

For a current list of known issues, go to the PayPal Notifications page and search for Invoicing related events.

New Calls

  • RemindInvoice

Changed Calls

  • CreateInvoice
  • CreateandSendInvoice
  • UpdateInvoice
  • GetInvoiceDetails

Schema Changes

Name Part of Schema Type of Change
RemindInvoice API Operation New
InvoiceType.taxInclusive Element New
BusinessInfoType.taxId Element New
PaymentTermsType.NoDueDate Enum New

New features

Due Date Is Unnecessary for Invoices

Updated August 20, 2013: You can create an invoice with no due date by specifying a NoDueDate value in paymentTerms. Additionally, when you create or update an invoice, the paymentTerms field now is optional. This change affects the following calls:

  • CreateInvoice
  • CreateandSendInvoice
  • UpdateInvoice
  • GetInvoiceDetails

Increased Number of Characters for Certain Fields

Updated August 20, 2013: The following fields have increased character limits, as follows:

Complex Type Element Character Maximum
InvoiceType Terms 4000
InvoiceType Note 4000
InvoiceItemType Name 60
InvoiceItemType Description 1000

This change affects the following calls:

  • CreateInvoice
  • CreateandSendInvoice
  • UpdateInvoice
  • GetInvoiceDetails

Sending a Reminder that a Payment is Due

The RemindInvoice API sends a reminder that a payment is due. This API is useful when a customer needs to be notified that an existing invoice needs to be paid.

A merchant who uses the RemindInvoice API intends to send the reminder for an existing invoice that already has been sent to the customer. The reminder can be sent to the customer as often as desired.

Including Tax in the Item Amount

You can specify whether an item amount is tax inclusive or tax exclusive. An item amount is the unit price multiplied by the quantity.

Specifically, you can use the taxInclusive field when you create or update an invoice. By default, the taxInclusive field is false. To specify true or false in the taxInclusive field, please use the following definitions:

  • Tax exclusive: The stated tax is added on top of the item or shipping amount.
  • Tax inclusive: The item or shipping amount already includes the stated tax.

If the taxInclusive field is true, the tax is calculated as follows: [Item Amount] - ([Item Amount]/(1+[Tax %])

If the taxInclusive field is false, the tax is calculated as follows: [Item Amount] * [Tax %]

Specifying the Merchant's Tax ID

You can include a merchant's tax ID when you create an invoice, enabling the display of the tax ID on the invoice.

Changed functionality

None

Additional Documentation Updates

None.