Create Vendor Credit

Creates a new VendorCredit in QuickBooks.

Loading API schema for VendorCredit…

POST/api/v1/vendor-credit

curl -X POST "https://api.nx-us.net/api/v1/vendor-credit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Connection-Id: YOUR_CONNECTION_ID" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "vendorId": "10000001-1039043346",
  "payablesAccountId": "<string>",
  "transactionDate": "2025-01-01",
  "refNumber": "REF12345",
  "memo": "Memo for the vendor credit",
  "isTaxIncluded": "<boolean>",
  "salesTaxCodeId": "10000001-1039043346",
  "exchangeRate": "1.25",
  "externalId": "<string>",
  "expenseLines": [
    {
      "accountId": "10000001-1039043346",
      "amount": 100,
      "memo": "Expense line memo"
    }
  ],
  "itemLines": [
    {
      "itemId": "10000001-1039043346",
      "quantity": 2,
      "rate": 50,
      "memo": "Item line memo"
    }
  ],
  "itemGroupLines": [
    {
      "itemGroupId": "10000001-1039043346",
      "quantity": 1,
      "rate": 200,
      "memo": "Item group line memo"
    }
  ]
}'

Response201

{
  "id": "<string>",
  "objectType": "<string>",
  "createdAt": "<date-time>",
  "updatedAt": "<date-time>",
  "revisionNumber": "<string>",
  "transactionDate": "<date>",
  "currency": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "exchangeRate": "<number>",
  "refNumber": "<string>",
  "memo": "<string>",
  "transactionNumber": "<integer>",
  "entity": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "vendor": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "account": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "payablesAccount": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "creditAmount": "<number>",
  "creditAmountInHomeCurrency": "<number>",
  "isTaxIncluded": "<boolean>",
  "salesTaxCode": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "openAmount": "<number>",
  "amountInHomeCurrency": "<string>",
  "hasValidLineItems": "<boolean>",
  "externalId": "<string>",
  "linkedTransactions": [
    {
      "objectType": "<string>",
      "transactionId": "<string>",
      "transactionType": "<string>",
      "transactionDate": "<date>",
      "refNumber": "<string>",
      "linkType": "<string>",
      "amount": "<number>"
    }
  ],
  "expenseLines": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "account": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "amount": "<number>",
      "memo": "<string>",
      "class": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "customer": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "salesRepresentative": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "salesTaxCode": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "taxAmount": "<number>",
      "vendor": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "billableStatus": "NotBillable",
      "customFields": [
        {
          "ownerId": null,
          "name": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "itemLines": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "otherCustomField1": "<string>",
      "otherCustomField2": "<string>",
      "item": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "description": "<string>",
      "quantity": "<number>",
      "cost": "<number>",
      "amount": "<number>",
      "customer": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "class": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "overrideItemAccount": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "billableStatus": "NotBillable",
      "itemGroup": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "unitOfMeasure": "<string>",
      "rate": "<number>",
      "salesTaxCode": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "inventorySite": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "inventorySiteLocation": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "serialNumber": "<string>",
      "lotNumber": "<string>",
      "serviceDate": "<date>",
      "customFields": [
        {
          "ownerId": null,
          "name": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "itemGroupLines": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "itemGroup": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "description": "<string>",
      "quantity": "<number>",
      "totalAmount": "<number>",
      "unitOfMeasure": "<string>",
      "isPrintItemsInGroup": "<boolean>",
      "lines": [
        {
          "id": null,
          "objectType": null,
          "otherCustomField1": null,
          "otherCustomField2": null,
          "item": null,
          "description": null,
          "quantity": null,
          "cost": null,
          "amount": null,
          "customer": null,
          "class": null,
          "overrideItemAccount": null,
          "billableStatus": null,
          "itemGroup": null,
          "unitOfMeasure": null,
          "rate": null,
          "salesTaxCode": null,
          "inventorySite": null,
          "inventorySiteLocation": null,
          "serialNumber": null,
          "lotNumber": null,
          "serviceDate": null,
          "customFields": null
        }
      ],
      "customFields": [
        {
          "ownerId": null,
          "name": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "customFields": [
    {
      "ownerId": "<string>",
      "name": "<string>",
      "type": "<string>",
      "value": "<string>"
    }
  ]
}