CreateSalesInvoice

Description

This method creates a new sales invoice.

Parameters

Interfaces

• Dynamics GP
• Sales

Examples

The following C# example creates a sales invoice. The example first populates the required DocumentTypeKey, CustomerKey, and BatchKey properties. The sales invoice uses a sales invoice line to specify the item and quantity sold. The sales invoice line requires the ItemKey, and Quantity properties to be populated. The sales invoice key and sales invoice line key are not populated. The CreateSalesInvoice operation automatically populates the empty sales invoice key and sales invoice line key with the next available invoice number. All other sales invoice properties are set to default values. The CreateSalesInvoice operation saves the new sales invoice.

** Legacy endpoint**

using System;
using System.Collections.Generic;
using System.Text;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            SalesInvoice salesInvoice;
            SalesDocumentTypeKey salesInvoiceType;
            CustomerKey customerKey;
            BatchKey batchKey;
            SalesInvoiceLine salesInvoiceLine;
            ItemKey invoiceItem;
            Quantity invoiceCount;
            Policy salesInvoiceCreatePolicy;

            // Create an instance of the service
            DynamicsGP wsDynamicsGP = new DynamicsGP();

            // Be sure the default credentials are used
            wsDynamicsGP.UseDefaultCredentials = true;

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context object
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create a sales invoice object
            salesInvoice = new SalesInvoice();

            // Create a sales document type key for the sales invoice
            salesInvoiceType = new SalesDocumentTypeKey();
            salesInvoiceType.Type = SalesDocumentType.Invoice;

            // Populate the document type key for the sales invoice
            salesInvoice.DocumentTypeKey = salesInvoiceType;

            // Create a customer key
            customerKey = new CustomerKey();
            customerKey.Id = "AARONFIT0001";

            // Set the customer key property of the sales invoice
            salesInvoice.CustomerKey = customerKey;

            // Create a batch key
            batchKey = new BatchKey();
            batchKey.Id = "SALES INVOICES";

            // Set the batch key property of the sales invoice object
            salesInvoice.BatchKey = batchKey;

            // Create a sales invoice line to specify the invoiced item
            salesInvoiceLine = new SalesInvoiceLine();

            // Create an item key
            invoiceItem = new ItemKey();
            invoiceItem.Id = "32X IDE";

            // Set the item key property of the sales invoice line object
            salesInvoiceLine.ItemKey = invoiceItem;

            // Create a sales invoice quatity object
            invoiceCount = new Quantity();
            invoiceCount.Value = 2;

            // Set the quantity of the sales invoice line object
            salesInvoiceLine.Quantity = invoiceCount;

            // Create an array of sales invoice lines
            // Initialize the array with the sales invoice line object
            SalesInvoiceLine[] invoiceLines = { salesInvoiceLine };

            // Add the sales invoice line array to the sales line object
            salesInvoice.Lines = invoiceLines;

            // Get the create policy for the sales invoice object
            salesInvoiceCreatePolicy = wsDynamicsGP.GetPolicyByOperation("CreateSalesInvoice", context);

            // Create the sales invoice
            wsDynamicsGP.CreateSalesInvoice(salesInvoice, context, salesInvoiceCreatePolicy);
        }
    }
}

** Native endpoint **

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            SalesInvoice salesInvoice;
            SalesDocumentTypeKey salesInvoiceType;
            CustomerKey customerKey;
            BatchKey batchKey;
            SalesInvoiceLine salesInvoiceLine;
            ItemKey invoiceItem;
            Quantity invoiceCount;
            Policy salesInvoiceCreatePolicy;

            // Create an instance of the service
            DynamicsGPClient wsDynamicsGP = new DynamicsGPClient();

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context object
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create a sales invoice object
            salesInvoice = new SalesInvoice();

            // Create a sales document type key for the sales invoice
            salesInvoiceType = new SalesDocumentTypeKey();
            salesInvoiceType.Type = SalesDocumentType.Invoice;

            // Populate the document type key for the sales invoice
            salesInvoice.DocumentTypeKey = salesInvoiceType;

            // Create a customer key
            customerKey = new CustomerKey();
            customerKey.Id = "AARONFIT0001";

            // Set the customer key property of the sales invoice
            salesInvoice.CustomerKey = customerKey;

            // Create a batch key
            batchKey = new BatchKey();
            batchKey.Id = "SALES INVOICES";

            // Set the batch key property of the sales invoice object
            salesInvoice.BatchKey = batchKey;

            // Create a sales invoice line to specify the invoiced item
            salesInvoiceLine = new SalesInvoiceLine();

            // Create an item key
            invoiceItem = new ItemKey();
            invoiceItem.Id = "32X IDE";

            // Set the item key property of the sales invoice line object
            salesInvoiceLine.ItemKey = invoiceItem;

            // Create a sales invoice quatity object
            invoiceCount = new Quantity();
            invoiceCount.Value = 2;

            // Set the quantity of the sales invoice line object
            salesInvoiceLine.Quantity = invoiceCount;

            // Create an array of sales invoice lines
            // Initialize the array with the sales invoice line object
            SalesInvoiceLine[] invoiceLines = { salesInvoiceLine };

            // Add the sales invoice line array to the sales line object
            salesInvoice.Lines = invoiceLines;

            // Get the create policy for the sales invoice object
            salesInvoiceCreatePolicy = wsDynamicsGP.GetPolicyByOperation("CreateSalesInvoice", context);

            // Create the sales invoice
            wsDynamicsGP.CreateSalesInvoice(salesInvoice, context, salesInvoiceCreatePolicy);

            // Close the service
            if(wsDynamicsGP.State != CommunicationState.Faulted)
            {
                wsDynamicsGP.Close();
            }
        }
    }
}