{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"params":[],"method":"get"},"next":{"description":"","pages":[]},"title":"Integrating with QuickBooks Online","type":"basic","slug":"integrating-with-quickbooks-online","excerpt":"","body":"# Overview\nApruve's integration for QuickBooks Online allows you to create Orders and Invoices in Apruve by creating and updating transactions in QuickBooks.  As you create and modify transactions in QuickBooks, Apruve automatically recognizes these changes and imports them into Apruve.\n\n# Installation\n\nOn your Apruve settings page, you will find a QuickBooks section.   Go to this section, then click the \ngreen QuickBooks Connect button.  \n\n![Settings Page](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_connect_settings.png)\n\nIf you're not already signed in to your QuickBooks account, you'll be asked to do so at this point.  \n\n![QuickBooks Signin](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_signin.png)\n\nClick 'Authorize' to grant Apruve access to your QuickBooks data.\n\n![QuickBooks Authorization](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_authorize.png)\n\n### Changes to Your QuickBooks Configuration\nAs part of the connection process, Apruve will add a sales term named 'Apruve Account' to your QuickBooks configuration. Using this sales term on your Invoices will set the due date according to the terms of your Apruve corporate account program.\n\n# Usage\nIn Apruve's workflow, an Order is used to capture your buyer's authorization for a purchase.  Once you have an approved Order, you can issue Invoices against that Order.  The Invoices can then be paid out by the bank that is backing your credit program.\n\nApruve's QuickBooks integration allows you to manage this process directly from QuickBooks.  Just follow these two simple steps:\n\n1. Create an Estimate for a customer with an Apruve account.  The customer will get an email from Apruve asking them to confirm that they want to put the order on their account.\n2. Once the customer accepts the Estimate, create an Invoice from the Estimate\n\n## Managing Apruve Orders Through QuickBooks\nTo create an Apruve Order, simply create a QuickBooks Estimate for a customer that has an Apruve corporate account.  Apruve will see the new estimate and create a matching Apruve Order for it.  \n\n![Create Estimate](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_create_estimate.png)\n\nWhen you save the Estimate, Apruve will send an email to them asking them to confirm that they want to place the order on their corporate account.  Once the buyer confirms the order, the status of the Estimate will update to 'Accepted' in QuickBooks, and you will receive an email from Apruve notifying you that an order was approved.\n\n## Managing Invoices for Apruve Orders\n\n### Creating Invoices\nTo add an invoice to an Apruve Order, create an Invoice in QuickBooks and link it to the Estimate you created in the previous step.  The easiest way to do this is to find the Estimate in the transaction list and use the Start Invoice action on it.  \n\n![Start Invoice](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_start_invoice.png)\n\nTo accurately set the due date on the Invoice, you should set the Sales Term field to 'Apruve Account'.   \n\nOnce Apruve processes your Invoice, the Statement Memo field will be updated with the Invoice's Apruve ID.  You will need this value if you need to report a return on the invoice (see [Managing Returns](/v4.0/docs/integrating-with-quickbooks-online#section-managing-returns) below).\n\n### Getting Paid  \nApruve cannot finance any invoice until we have shipping details for it.  For QuickBooks, that means filling in the shipping fields on the invoice.  You can either use a shipping plugin that sets these fields for you, or you can add them to your sales forms and set them yourself.\n\n![Shipping Details](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_shipping_detail.png)\n\nOnce an Invoice both is sent to the buyer and has shipping details, the bank will initiate a deposit to your bank account within a business day.  Apruve will add a Payment to QuickBooks to show the deposit.\n\n![Apruve Invoice ID](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks-invoice-apruve-id.png)\n\n## Managing Returns\nWhenever a buyer returns goods purchased via Orders financed with Apruve, those returns need to be reported in order to adjust the amount that Apruve will attempt to collect from the buyer.\n\n### Reporting a Return\nTo report a return to Apruve, create a CreditMemo for the amount of the returned goods, specifying the Apruve ID of the invoice in the CreditMemo's Memo field.  (You can find an Invoice's Apruve ID in its Statement Memo field.)  Apruve will process the CreditMemo as soon as it is saved.\n\n![Create Credit Memo](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks-credit-memo-invoice.png)\n\n# Disconnecting QuickBooks\nTo disconnect Apruve from QuickBooks, go to your Apruve settings page.  In the QuickBooks section, you will find a link for disconnecting from QuickBooks.\n\n![Disconnect Page](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_disconnect_settings.png)\n\nOnce disconnected, Apruve will no longer process Estimates and Invoices created in QuickBooks, and will no longer update QuickBooks based on changes made in Apruve.\n\n# What Data Does Apruve Access?\nThe Apruve QuickBooks integration accesses the following parts of your QuickBooks data:\n \n#### Estimate\nApruve inspects the billing email address of every Estimate created to determine if the address belongs to an authorized buyer on an Apruve corporate account at your business.  If it does the rest of the information on the Estimate is used to create an Apruve Order.\n\nEstimate status and memo fields are updated based on what happens during processing of the Apruve Order. No other Estimate data is changed.  Apruve does not create new estimates or delete existing ones.  \n\n#### Invoice\nApruve inspects the linked transactions of every Invoice created to determine if any of them are an Estimate previously processed by Apruve into an Order.  If the Invoice is linked to an Apruve Order, the details of the Invoice are used to create an Apruve Invoice.\n\nApruve will void an Invoice on QuickBooks if the corresponding Apruve invoice is canceled.  Apruve does not otherwise alter, create, or delete Invoice data.  \n\n#### Payment\nApruve does not modify existing Payments.  Apruve will create Payments and apply them to invoices when banks deposit funds for those invoices into your account.\n\n#### CreditMemo\nApruve inspects the private notes of every CreditMemo created to determine if it contains an Apruve Invoice identifier.  If an identifier is found, the details of the CreditMemo are used to create a Return on the Apruve Invoice. \n\nApruve does not create, update, or delete CreditMemos.\n\n#### Item\nApruve will retrieve the details of an Item when that Item is referenced in the lines of an Estimate or Invoice that Apruve is processing.\n\nApruve does not create, update, or delete Items.\n\n#### Term\nApruve creates a Term named 'Apruve Account' as part of the installation process.  This Term has its due date details set to match the terms of your Apruve corporate account program.\n\n# More Info\n\nFor more information about QuickBooks please click here: [https://quickbooks.intuit.com/accounting/ ](https://quickbooks.intuit.com/accounting/)","updates":[],"order":8,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"598364dc79391c001e55930a","project":"58b9e955fba7da250056ff86","version":{"version":"4.0","version_clean":"4.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["58b9e955fba7da250056ff8a","58b9e9e168a4a5190011dcc2","58b9ea1de87271190074c623","58b9f9df4022e60f00ae20af","58bda4f77181082500275455","58bda69b8bcd092f00e52862","58bda751b4e9640f00e4bdaf","58e800fabc0deb0f002801f3","5925bfd9504e5239003807f4","5925c026aef9fd27008525c0","5925c0e7dd71b51b00ccc329","592d872451a3e80f00eb4a1a","592d9539b9b6b91900569ea0","592d990a51a3e80f00eb4c25","592d9bf480832f0f00ddfa46","592d9d5051a3e80f00eb4e02","592dbd5cd97832190073d76a","598360d76050430034ef4e07","598363237c926c0028d2e420","598363755de0a1002049efad","598363c27c926c0028d2e442","59c15f2ebc639a0032f770f0"],"_id":"58b9e955fba7da250056ff89","releaseDate":"2017-03-03T22:08:21.880Z","__v":22,"createdAt":"2017-03-03T22:08:21.880Z","project":"58b9e955fba7da250056ff86"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Integrations","slug":"ecommerce-integrations","order":4,"from_sync":false,"reference":false,"_id":"598363755de0a1002049efad","project":"58b9e955fba7da250056ff86","version":"58b9e955fba7da250056ff89","isAPI":false,"createdAt":"2017-08-03T17:55:01.947Z","__v":0},"user":"596f95a2be66bb002e66a935","createdAt":"2017-08-03T18:01:00.812Z","githubsync":"","__v":0,"parentDoc":null,"updatedAt":"2019-09-20T20:26:22.115Z"}

Integrating with QuickBooks Online


# Overview Apruve's integration for QuickBooks Online allows you to create Orders and Invoices in Apruve by creating and updating transactions in QuickBooks. As you create and modify transactions in QuickBooks, Apruve automatically recognizes these changes and imports them into Apruve. # Installation On your Apruve settings page, you will find a QuickBooks section. Go to this section, then click the green QuickBooks Connect button. ![Settings Page](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_connect_settings.png) If you're not already signed in to your QuickBooks account, you'll be asked to do so at this point. ![QuickBooks Signin](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_signin.png) Click 'Authorize' to grant Apruve access to your QuickBooks data. ![QuickBooks Authorization](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_authorize.png) ### Changes to Your QuickBooks Configuration As part of the connection process, Apruve will add a sales term named 'Apruve Account' to your QuickBooks configuration. Using this sales term on your Invoices will set the due date according to the terms of your Apruve corporate account program. # Usage In Apruve's workflow, an Order is used to capture your buyer's authorization for a purchase. Once you have an approved Order, you can issue Invoices against that Order. The Invoices can then be paid out by the bank that is backing your credit program. Apruve's QuickBooks integration allows you to manage this process directly from QuickBooks. Just follow these two simple steps: 1. Create an Estimate for a customer with an Apruve account. The customer will get an email from Apruve asking them to confirm that they want to put the order on their account. 2. Once the customer accepts the Estimate, create an Invoice from the Estimate ## Managing Apruve Orders Through QuickBooks To create an Apruve Order, simply create a QuickBooks Estimate for a customer that has an Apruve corporate account. Apruve will see the new estimate and create a matching Apruve Order for it. ![Create Estimate](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_create_estimate.png) When you save the Estimate, Apruve will send an email to them asking them to confirm that they want to place the order on their corporate account. Once the buyer confirms the order, the status of the Estimate will update to 'Accepted' in QuickBooks, and you will receive an email from Apruve notifying you that an order was approved. ## Managing Invoices for Apruve Orders ### Creating Invoices To add an invoice to an Apruve Order, create an Invoice in QuickBooks and link it to the Estimate you created in the previous step. The easiest way to do this is to find the Estimate in the transaction list and use the Start Invoice action on it. ![Start Invoice](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_start_invoice.png) To accurately set the due date on the Invoice, you should set the Sales Term field to 'Apruve Account'. Once Apruve processes your Invoice, the Statement Memo field will be updated with the Invoice's Apruve ID. You will need this value if you need to report a return on the invoice (see [Managing Returns](/v4.0/docs/integrating-with-quickbooks-online#section-managing-returns) below). ### Getting Paid Apruve cannot finance any invoice until we have shipping details for it. For QuickBooks, that means filling in the shipping fields on the invoice. You can either use a shipping plugin that sets these fields for you, or you can add them to your sales forms and set them yourself. ![Shipping Details](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_shipping_detail.png) Once an Invoice both is sent to the buyer and has shipping details, the bank will initiate a deposit to your bank account within a business day. Apruve will add a Payment to QuickBooks to show the deposit. ![Apruve Invoice ID](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks-invoice-apruve-id.png) ## Managing Returns Whenever a buyer returns goods purchased via Orders financed with Apruve, those returns need to be reported in order to adjust the amount that Apruve will attempt to collect from the buyer. ### Reporting a Return To report a return to Apruve, create a CreditMemo for the amount of the returned goods, specifying the Apruve ID of the invoice in the CreditMemo's Memo field. (You can find an Invoice's Apruve ID in its Statement Memo field.) Apruve will process the CreditMemo as soon as it is saved. ![Create Credit Memo](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks-credit-memo-invoice.png) # Disconnecting QuickBooks To disconnect Apruve from QuickBooks, go to your Apruve settings page. In the QuickBooks section, you will find a link for disconnecting from QuickBooks. ![Disconnect Page](https://s3.amazonaws.com/apruve-documentation-resources/quickbooks_disconnect_settings.png) Once disconnected, Apruve will no longer process Estimates and Invoices created in QuickBooks, and will no longer update QuickBooks based on changes made in Apruve. # What Data Does Apruve Access? The Apruve QuickBooks integration accesses the following parts of your QuickBooks data: #### Estimate Apruve inspects the billing email address of every Estimate created to determine if the address belongs to an authorized buyer on an Apruve corporate account at your business. If it does the rest of the information on the Estimate is used to create an Apruve Order. Estimate status and memo fields are updated based on what happens during processing of the Apruve Order. No other Estimate data is changed. Apruve does not create new estimates or delete existing ones. #### Invoice Apruve inspects the linked transactions of every Invoice created to determine if any of them are an Estimate previously processed by Apruve into an Order. If the Invoice is linked to an Apruve Order, the details of the Invoice are used to create an Apruve Invoice. Apruve will void an Invoice on QuickBooks if the corresponding Apruve invoice is canceled. Apruve does not otherwise alter, create, or delete Invoice data. #### Payment Apruve does not modify existing Payments. Apruve will create Payments and apply them to invoices when banks deposit funds for those invoices into your account. #### CreditMemo Apruve inspects the private notes of every CreditMemo created to determine if it contains an Apruve Invoice identifier. If an identifier is found, the details of the CreditMemo are used to create a Return on the Apruve Invoice. Apruve does not create, update, or delete CreditMemos. #### Item Apruve will retrieve the details of an Item when that Item is referenced in the lines of an Estimate or Invoice that Apruve is processing. Apruve does not create, update, or delete Items. #### Term Apruve creates a Term named 'Apruve Account' as part of the installation process. This Term has its due date details set to match the terms of your Apruve corporate account program. # More Info For more information about QuickBooks please click here: [https://quickbooks.intuit.com/accounting/ ](https://quickbooks.intuit.com/accounting/)