Servicios web de distribución digital (DDWS) GetInvoice - Manual del servicio

Transcripción

1 Servicios web de distribución digital (DDWS) GetInvoice - Manual del servicio

2 CONTENIDO Historial de revisiones Introducción Descripción general Documentación complementaria Para empezar Descripción general del servicio GetInvoice GetInvoiceList GetInvoiceDetails Ventajas del servicio GetInvoice Información de referencia del servicio GetInvoice Una nota sobre varios CSN Esquema de solicitud Esquema de respuesta GetInvoiceList GetInvoiceDetails Esquema de error Mensaje de solicitud Mensaje de solicitud: GetInvoiceList Mensaje de solicitud: GetInvoiceDetails Mensaje de respuesta Mensaje de respuesta: GetInvoiceList Mensaje de respuesta: GetInvoiceDetails Mensajes de error Ejemplo de respuesta de error Apéndice Código en C# para introducir varios CSN Programa principal Clase Utils POCO Manual de referencia del servicio web

3 Historial de revisiones Versión Fecha Autor Comentarios /10/2015 AR Se ha agregado la sección de historial de revisiones /12/2015 AR Se han añadido los campos adsk_vat_number, recurring_po, total_amount en invoice_header para la respuesta de GetInvoiceDetails en la sección /12/2015 AR Se ha cambiado la longitud máxima de purchase_order_number a 35 caracteres en la sección /02/2016 RL Se han añadido los campos bill_per_start_dt y bill_per_end_dt a invoice_items /02/2016 ER Se ha actualizado la descripción de contract_end. 3 Manual de referencia del servicio web

4 1 Introducción 1.1 Descripción general La plataforma de servicios web de distribución digital (DDWS) es una solución de automatización que permite a nuestros distribuidores realizar pedidos directamente a Autodesk; este proceso requiere muy pocos pasos por parte de los distribuidores y ninguno por parte de Autodesk. Esta nueva función de negocio permitirá realizar verdaderas transacciones de servicio web B2B entre los distribuidores y Autodesk. Para que los distribuidores disfruten de una implementación eficaz de la plataforma de servicios digitales de Autodesk, las filiales deberán familiarizarse con los servicios web de REST, OAuth y JSON. En un documento llamado Guía de programación, se ofrece un ejemplo de aplicación cliente (escrita en lenguaje Ruby) que ayudará a los desarrolladores de las filiales a usar la API del servicio digital. 1.2 Documentación complementaria Guía para desarrolladores de distribuidores de Autodesk: esta guía ayudará a los distribuidores en su proceso de incorporación y acceso a los servicios de DDWS. La guía sirve también para presentar a los distribuidores la plataforma de servicios digitales de Autodesk, con instrucciones paso a paso que les guiarán a través de las actividades iniciales necesarias para la integración. Documentación de la API de autenticación: este documento guía a los distribuidores a través del proceso de generación de credenciales, firmas y tokens de acceso necesarios para utilizar las API del servicio. También contiene información para el desarrollo de la aplicación de integración de un distribuidor. Proporciona información básica acerca de la integración del servicio web y muestra el desarrollo de una aplicación típica. 2 Para empezar Como parte del proceso de incorporación, los distribuidores deberán estar asociados con un único número específico del cliente (CSN, del inglés Customer Specific Number) y su aplicación deberá estar registrada con Autodesk. Para obtener más información sobre el proceso de incorporación, consulte la Guía para desarrolladores de distribuidores de Autodesk. 4 Manual de referencia del servicio web

5 3 Descripción general del servicio GetInvoice Pueden existir casos en los que la entrada realizada por el solicitante tenga un intervalo de fechas (fecha de inicio y fecha de fin). En este caso, el servicio no puede proporcionar todos los detalles de la factura para un determinado periodo de tiempo, ya que existe la posibilidad de tener una gran cantidad de facturas a lo largo de cualquier período determinado. Existen dos operaciones definidas en este servicio para la extracción de facturas: getinvoicelist getinvoicedetails El diagrama anterior es una descripción del servicio getinvoice. Al implementar la plataforma de servicios digitales de Autodesk, puede realizar sus procesos de forma más eficaz. La siguiente serie de gráficos muestra una experiencia del usuario con la tienda web. Esta primera captura de pantalla muestra cómo se va a llamar la operación getinvoicelist. Los clientes introducirán un intervalo de fechas para obtener las facturas correspondientes a un determinado periodo. En función de esta entrada, se mostrarán al cliente todas las facturas que caigan dentro del intervalo de fechas. 5 Manual de referencia del servicio web

6 Después de recibir la lista de facturas, los clientes pueden obtener detalles de las facturas para un determinado número de factura, número de pedido de compra o número de pedido de ventas, tal como se muestra en la siguiente captura de pantalla. 6 Manual de referencia del servicio web

7 3.1 GetInvoiceList La finalidad de esta operación es obtener la lista de facturas de un sistema administrativo si la entrada solo incluye un intervalo de fechas. Una vez que el solicitante reciba la respuesta, llamará a getinvoicedetails usando como entrada el número de factura, el número de pedido de compra o el número de pedido de ventas. Las siguientes entradas son necesarias para llamar al servicio: 1. customer_number 2. invoice_date_from 3. invoice_date_to 3.2 GetInvoiceDetails La finalidad de esta operación es obtener los detalles de las facturas para una entrada determinada. Para llamar a esta operación, se pueden usar los siguientes conjuntos de entradas: 1. customer_number y purchase_order_number/ invoice_number / sales_order_number Si los tres parámetros (po_number, invoice_number y order_number) están presentes en una solicitud de servicio, la prioridad de los criterios de búsqueda se definirá de la siguiente manera: 1. invoice_number (alta) 2. purchase_order_number 3. sales_order_number (baja) Nota: Solo se rellenará una factura válida como parte de la respuesta de la API de GetInvoice. 3.3 Ventajas del servicio GetInvoice 1. Un servicio web de REST optimizado que se puede consumir fácilmente desde cualquier aplicación a través de una conexión HTTP(s). 2. La capacidad de recuperar la información de la factura por distribuidor cuando sea necesario, lo que permite ahorrar el esfuerzo de buscar facturas en formato PDF en mensajes de correo electrónico o en datos de EDI IDoc. 3. El servicio ofrece a los distribuidores la flexibilidad de buscar facturas dentro de determinados intervalos de fecha o mediante los números de las facturas, los números de pedidos de compra o los números de ventas. 4. Los distribuidores pueden personalizar los datos de las facturas y agregarlos a su sistema interno según sea necesario. 7 Manual de referencia del servicio web

8 4 Información de referencia del servicio GetInvoice 4.1 Una nota sobre varios CSN El servicio GetInvoice solo admite un único customer_number (CSN) por solicitud. Si un distribuidor tiene varios CSN, entonces ese distribuidor debería tener la capacidad de llamar al servicio varias veces para obtener la información correspondiente. Una forma de hacer esto podría ser programar un bucle en la aplicación de conexión que llame al servicio GetInvoice una vez para cada uno de los CSN disponibles. Es importante que dicha secuencia de comandos también gestione la generación de credenciales y tokens de acceso para cada llamada. Un ejemplo completo de dicha secuencia de comandos se puede encontrar en la sección Apéndice de este Manual de referencia del servicio. A continuación, se incluye el segmento relevante de dicho ejemplo. // Looping through each CSN var container = new List<ResponseContainer>(); foreach (var csn in credentials.csns) // Signing partner's credentials var firstsignature = Utils.GetFirstSignature(credentials); // Sending request to OAuth server to generate an Access Token var tokendetails = Utils.CallOAuthEndPoint(firstSignature); credentials); // Signing Access Token var secondsignature = Utils.GetSecondSignature(tokenDetails, // Calling Get Invoice WebService var endpoint = string.format(" stg.autodesk.com/v1/invoices?customer_number=0&invoice_date_from= &invoice_date_to= ", csn); var invoice = Utils.GetInvoices(endPoint, secondsignature, csn); // Storing WebService's response var invoicecontainer = JsonConvert.DeserializeObject<InvoiceContainer>(invoice); container.add(new ResponseContainer CSN = csn, Response = invoicecontainer ); // Writing response to file var json = JsonConvert.SerializeObject(container, Formatting.Indented); Utils.WriteJsonToFile(json); 8 Manual de referencia del servicio web

9 4.2 Esquema de solicitud Los detalles de los parámetros del mensaje de solicitud están en la tabla siguiente para ambos getinvoicelist () y getinvoicedetails(). Elementos de getinvoicelis t() Elemento customer_number Invoice_date_from invoice_date_to Tipo de campo Cadena Fecha Fecha Longitud/formato de entrada Longitud: máx. 10 caracteres Formato: ISO 8601 AAAA-MM-DD Formato: ISO 8601 AAAA-MM-DD Utilización Obligatorio Obligatorio Obligatorio Elementos de getiinvoicedetails() customer_number invoice_number purchase_order_nu mber sales_order_numbe r Cadena Cadena Cadena Cadena Longitud: máx. 10 caracteres Longitud: 10 caracteres máx. Longitud: máx. 35 caracteres Longitud: máx. 10 caracteres Obligatorio Es posible pasar uno o todos junto con customer_number 4.3 Esquema de respuesta GetInvoiceList Nombre de campo Descripción invoice_number Número de factura bill_to_customer Número de cliente 1 purchase_order_number Número de orden de compra del cliente invoice_date Fecha de publicación en el documento Formato: ISO 8601 AAAA-MM-dd transaction_type invoice_total_amount invoice_currency account_doc_description customer_po_number sales_order_number Descripción del tipo de documento Cantidad en la moneda del documento Clave de moneda Texto de elemento Número de orden de compra del cliente Número de documento de distribución y ventas 9 Manual de referencia del servicio web

10 4.3.2 GetInvoiceDetails Nombre de campo invoice_number name bank_keys bank_number bank_branchid bank_account_number currency alternative_bank_account lockbox_number swiftcode iban bank_control_key country address city district region postalcode tel_number fax_number additional invoice_date invoice_number po_date order_date Descripción invoice_bankinfo Número de documento de distribución y ventas Nombre del banco Claves bancarias Número del banco Sucursal de banco Número de cuenta bancaria Moneda del banco Número de cuenta del banco alternativo (para número de cuenta ambiguo) Número de LockBox Código SWIFT para pagos internacionales IBAN (número de cuenta bancaria internacional) Clave de control bancaria País Dirección del banco Ciudad Distrito Región (estado, provincia, distrito) Código postal/apdo. de correos Número de teléfono Número de teléfono de fax Información adicional - Código ABI/Código CAB/GIRO/Código de clasificación, etc. invoice_header Fecha de facturación para índice e impresión de facturación Formato: ISO 8601 Número de documento de ventas y distribución Fecha de orden de compra del cliente Formato: ISO 8601 Fecha de pedido de ventas Formato: ISO 8601 AAAA-MM-dd purchase_order_number Número de pedido de compra del cliente customer_po_number Número de pedido de compra de la parte de destino transaction_type Car 20 ship_date Fecha Formato: ISO 8601 AAAA-MM-dd invoice_currency sales_order_number contract_number Moneda del documento SD Pedido Referencia interna deñ cliente o del proveedor 10 Manual de referencia del servicio web

11 payment_term payment_due Términos de pago Fecha de vencimiento del pago Formato: ISO 8601 AAAA-MM-dd local_currency Clave de moneda exchange_rate Tasa de cambio para la determinación del precio vat_number Número de registro del IVA delivery_code Incoterms (parte 1) delivery_description Incoterms (parte 2) delivery_number Entrega numbers_item Número natural tax_amount Importe del impuesto en la moneda del documento tax_type Tipo de impuesto tax_rate Tasa de impuesto freight_charge Carga de mercancías tracking_number Número de hoja de ruta opportunity_id Identificador de la oportunidad extra_po_identifier Identificador de compra adicional invoice_amount Valor neto en la moneda del documento weight_total Peso total weight_uom Unidad de peso reserve_header_field Campo encabezado de copia de seguridad adsk_vat_number Número de registro del IVA de Autodesk recurring_po Pedido de compra para pedidos en la suscripción periódica total_amount Valor neto + impuestos invoice_items invoice_number Documento de facturación line_number Elemento de facturación sku Número de material sku_description Texto corto para elemento de pedido de venta physical_media Valor de ELD de valor char invoice_currency Moneda del documento SD contract_start Fecha de inicio del contrato Formato: ISO 8601 AAAA-MM-dd contract_end quantity Fecha de finalización del contrato Formato: ISO 8601 AAAA-MM-DD Para suscripciones periódicas (mensual y anual), se aplican las siguientes reglas. Cuando el contrato se cancela, el campo contract_end muestra la fecha de cancelación. Cuando el contrato está en vigor, el campo contract_end muestra el texto "Contrato de renovación automática". Cantidad facturada real 11 Manual de referencia del servicio web

12 quantity_uom Unidad base de medida seats Número natural unit_price Precio por unidad unit_discount Descuento unitario net_value Valor neto del elemento de facturación en la moneda del documento serial_number Número de serie current_serial_number Número de serie actual old_serial_number Número de serie anterior partner_subs_id Número de suscripción de distribuidor vat_description Texto de IVA reserve_item_field Campo elemento de copia de seguridad bill_per_start_dt Fecha de inicio del período de facturación bill_per_end_dt Fecha de finalización del período de facturación invoice_partners invoice_number Número de documento de distribución y ventas line_number Artículo de facturación partner_type Tipo de cliente partner_number Número de cliente 1 contact_number Número de la persona de contacto partner_name Nombre street Número de la casa y la calle po_box Apdo. de correos city Ciudad postal_code Código postal pobox_postal_code Código postal del apdo. de correos country Nombre del país tel_number Primer número de teléfono fax_number Número de fax district Distrito region Región (estado, provincia, distrito) country_iso Código ISO del país 4.4 Esquema de error Nombre de campo status message transactionid Descripción Respuesta de confirmación: OK, FAILED, ERROR Mensaje para fallo o errores ID único de transacción (combinación de número de factura y sello horario) 4.5 Mensaje de solicitud En función de los parámetros de entrada, se ejecutará la operación getinvoicelist() o la operación getinvoicedetails(). Si la entrada tiene parámetros f echa de inicio y fecha de fin, entonces se ejecutará getinvoicelist(). Si la entrada tiene el Número de orden de compra, Número de factura o Número de pedido de ventas, se invocará getinvoicedetails(). A continuación, se incluyen solicitudes de ejemplo de ambas operaciones. 12 Manual de referencia del servicio web

13 4.5.1 Mensaje de solicitud: GetInvoiceList stg.autodesk.com/v1/invoices?customer_number= &invoice_date_from= &invoice_date_to= Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> 13 Manual de referencia del servicio web

14 4.5.2 Mensaje de solicitud: GetInvoiceDetails Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> OR es_order_number= Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> OR chase_order_number= Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> OR es_order_number= &purchase_order_number= Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> 4.6 Mensaje de respuesta 14 Manual de referencia del servicio web

15 Nota: Autodesk enviará una respuesta con la siguiente estructura. Los distribuidores pueden cambiar el formato de la respuesta a distintas estructuras en función de sus necesidades Mensaje de respuesta: GetInvoiceList ] "status": "OK", "transaction_id": "INV ", "message": [ "invoice_number": " ", "purchase_order_number": " ", "bill_to_customer": " ", "invoice_date": " , "customer_po_number": "", "transaction_type": "Invoice", "invoice_total_amount": 328.5, "invoice_currency": "USD", "account_doc_description": "", "sales_order_number": " ", "invoice_number": " ", "purchase_order_number ": " ", "bill_to_customer ": " ", "invoice_date": " ", "customer_po_number ": "", "transaction_type": "Invoice", "invoice_total_amount: , "invoice_currency": "USD", "account_doc_description ": "", "sales_order_number ": " " Mensaje de respuesta: GetInvoiceDetails "status": "OK", "transaction_id": "INV ", "message": [ "invoice_bankinfo": [ invoice_number : , "name": "Merghle", "bank_keys": "", "bank_number": "", 15 Manual de referencia del servicio web

16 , "bank_branchid": "", "bank_account_number": "", "currency": "", "alternative_bank_account": "", "lockbox_number": "", "swiftcode": "", iban": "", "bank_control_key": "", "country": "", "address": "", "city": "Carol Stream, IL ", district :, "region": "", "postalcode": "", "tel_number": ", "fax_number ": "", "additional": "MAIL PAYMENTS TO: AUTODESK, INC. C/O MERGHLE" invoice_number : , "name": "Merghle", "bank_keys": "", "bank_number": "", "bank_branchid": "", "bank_account_number": " ", "currency": "", "alternative_bank_account": "", "lockbox_number": "", "swiftcode": "", "iban": "", "bank_control_key": "", "country": "", "address": "", "city": "", district :, "region": "", "postalcode": "", "tel_number": ", "fax_number ": "", "additional": "ABA# /WIRE PAYMENTS TO:" ], "invoice_header": [ "invoice_date": " ", "invoice_number": " ", "po_date": " ", "order_date": " ", "purchase_order_number": "D _R2D2", "customer_po_number": "", "transaction_type": "Invoice", "ship_date": null, "invoice_currency": "USD", 16 Manual de referencia del servicio web

17 "sales_order_number": " ", "contract_number": "D ", "payment_term": "30", "payment_due": "Up to 11/23/2014 without deduction", "local_currency": "USD", "exchange_rate": 1, "vat_number": "", "delivery_code": "CIF", "delivery_description": "FOB Origin", "delivery_number": "", "numbers_of_items": 1, "tax_amount": 0, "tax_type": "TPS;TVQ", "tax_rate": "7.975%;7%", "tracking_number": "1ZR43W ", "extra_po_identifier": "", "freight_charge": 0, "opportunity_id": "", " invoice_amount": 30, "weight_total": 0, "weight_uom": "", "reserve_header_field": "" ], "invoice_items": [ "invoice_number": " ", "line_number": "000050", "sku": "961F1-WW6573-L994", "sku_description": "ADSKFD 2014 TL:MT SUB WW ELD", physical_media :, "invoice_currency": "USD", "contract_start": " ", "contract_end": " ", "quantity": 1, "quantity_uom": "EA", "seats": 0, "unit_price": 30, "unit_discount": 0, "net_value": 30, "serial_number": " ", "current_serial_number": "", "old_serial_number": "", "partner_subs_id": "", vat_description :, "reserve_item_field": "", "bill_per_start_dt": " T00:00: ", "bill_per_end_dt": " T00:00: " ], "invoice_partners": [ "invoice_number": " ", 17 Manual de referencia del servicio web

18 ,,, "line_number": "000000", "partner_type": "", "partner_number": "", "contact_number": " ", "partner_name": "Autochair Inc.", "street": "McInnis Parkway", "po_box": "", "city": "SAN ROFFEL", "postal_code": "94903", "pobox_postal_code": "", "country": "USA", "tel_number": " ", "fax_number": "", "district": "MARIN", "region": "CA" "invoice_number": " ", "line_number": "000000", "partner_type": "Sold to", "partner_number": " ", "contact_number": " ", "partner_name": "Quechua Rentals", "street": "410 Terry Ave N", "po_box": "", "city": "Seattle", "postal_code": " ", "pobox_postal_code": "", "country": "USA", "tel_number": "", "fax_number": "", "district": "KING", "region": "WA" "invoice_number": " ", "line_number": "000000", "partner_type": "Bill to", "partner_number": " ", "contact_number": " ", "partner_name": "Quechua Rentals", "street": "410 Terry Ave N", "po_box": "", "city": "Seattle", "postal_code": " ", "pobox_postal_code": "", "country": "USA", "tel_number": "", "fax_number": "", "district": "KING", "region": "WA" 18 Manual de referencia del servicio web

19 ] ], "invoice_number": " ", "line_number": "000000", "partner_type": "Ship to", "partner_number": " ", "contact_number": " ", "partner_name": "Quechua Rentals", "street": "410 Terry Ave N", "po_box": "", "city": "Seattle", "postal_code": " ", "pobox_postal_code": "", "country": "USA", "tel_number": "", "fax_number": "", "district": "KING", "region": "WA" "invoice_number": " ", "line_number": "000050", "partner_type": "Reseller", "partner_number": " ", "contact_number": " ", "partner_name": "Quechua Rentals", "street": "410 Terry Ave N", "po_box": "", "city": "Seattle", "postal_code": " ", "pobox_postal_code": "", "country": "USA", "tel_number": "", "fax_number": "", "district": "KING", "region": "WA" Nota: En el caso de varios tipos de impuestos y tipos de cambio, el servicio devolverá datos como se muestra a continuación. Aquí los valores estás separados con ";" y tax_type y tax_rate se incluirán en secuencia (es decir, tax_rate 7,975% corresponde al tipo de impuesto "TPS" y tax_rate "7%" corresponde a tax_type "TVQ") 4.7 Mensajes de error La siguiente tabla muestra los códigos de error y sus respectivos mensajes de error presentes en los mensajes de respuesta si se detecta un error: 19 Manual de referencia del servicio web

20 Mensaje de error Código de error Descripción del error Indique el número de cliente. UAN-GEN Número de cliente con valor en blanco El campo no se puede dejar en blanco. Introduzca la fecha. El intervalo de fechas no debe ser superior a 90 días. Compruebe la entrada y vuelva a intentarlo. El Número de cliente no debe superar los 10 caracteres. Compruebe la entrada y vuelva a intentarlo. Introduzca una Fecha de inicio válida en el formato AAAA-MM-DD. Introduzca una Fecha de fin válida en el formato AAAA-MM-DD Problema del sistema que impide el procesamiento. Inténtelo de nuevo más tarde Número de factura debería tener 10 caracteres exactamente. Compruebe la entrada y vuelva a intentarlo. El Número de pedido de ventas debe tener 10 caracteres exactos. Compruebe la entrada y vuelva a intentarlo. La Fecha de inicio de la factura debe ser anterior a la Fecha de fin de la factura. El número de cliente suministrado no es válido. UAN-GEN UAN-GEN UAN-GEN UAN-GEN UAN-GEN UAN-GEN UAN-GEN UAN-GEN UAN-INV APG-DWS-INV- 002 Fecha de factura desde / fecha de factura hasta con un valor en blanco Para comprobar si el intervalo de fechas es superior a 90 días Para comprobar si Número de cliente tiene más de 10 caracteres Para comprobar el formato de fecha Para comprobar el formato de fecha Excepción técnica Para comprobar si Número de factura es menor o mayor de 10 caracteres Para comprobar si el Número de pedido de ventas es menor o mayor de 10 caracteres Para comprobar si el valor de Fecha desde de factura es anterior a la Fecha hasta de factura Si el CSN enviado por el distribuidor no es válido "status": "OK", "transaction_id": "INV ", "message": [] - Capa de servicio para devolver una respuesta con un mensaje en blanco si no se encuentra ningún registro para la búsqueda actual 20 Manual de referencia del servicio web

21 4.7.1 Ejemplo de respuesta de error "status": "Error", "transactionid": "INV ", "message": [ "error_code": "UAN-GEN-00108", "error_message": "Please enter Customer Number" ] 5 Apéndice 5.1 Código en C# para introducir varios CSN A continuación se muestra un ejemplo de un archivo de comandos que pueden escribir los distribuidores para introducir varios CSN en el servicio GetInvoice. Dado que el servicio GetInvoice solo puede procesar un único CSN por solicitud, es necesario programar la aplicación con este requisito en mente. Una forma de hacer esto es programar un bucle que realiza una solicitud para cada CSN suministrado, teniendo en cuenta la generación de firmas y los tokens de acceso. A continuación se muestra un ejemplo de código que realiza ese proceso Programa principal using System; using System.Collections.Generic; using System.Text; using MultipleInvoiceCallPoC.POCOs; using Newtonsoft.Json; using System.Diagnostics; using System.Threading; namespace MultipleInvoiceCallPoC class Program static void Main(string[] args) //"Acquiring credentials var credentials = new Credentials BasePath = " ConsumerKey = "AbM03alqHyT3uv3D3cYQV0gq8K0kkKNf", ConsumerSecret = "SCqY7IKSoIZ1ZbY5", CSNs = new List<string>() " ", " ", " ", " ", 21 Manual de referencia del servicio web

22 ; " " // Looping through each CSN var container = new List<ResponseContainer>(); foreach (var csn in credentials.csns) // Signing partner's credentials var firstsignature = Utils.GetFirstSignature(credentials); // Sending request to OAuth server to generate an Access Token var tokendetails = Utils.CallOAuthEndPoint(firstSignature); // Signing Access Token var secondsignature = Utils.GetSecondSignature(tokenDetails, credentials); // Calling Get Invoice WebService var endpoint = string.format(" stg.autodesk.com/v1/invoices?customer_number=0&invoice_date_from= &invoice_date_to= ", csn); var invoice = Utils.GetInvoices(endPoint, secondsignature, csn); // Storing WebService's response var invoicecontainer = JsonConvert.DeserializeObject<InvoiceContainer>(invoice); container.add(new ResponseContainer CSN = csn, Response = invoicecontainer ); // Writing response to file var json = JsonConvert.SerializeObject(container, Formatting.Indented); Utils.WriteJsonToFile(json); 22 Manual de referencia del servicio web

23 5.1.2 Clase Utils public class Utils /// Sets up the OAuth URL end-point and headers to be send in the request in order to /// generate the Access Token /// <param name="url">string that contains the OAuth URL end-point</param> /// <param name="firstsignature">class that contains Partner's signed credentials</param> /// <returns>string with a JSON object</returns> public static string GetAccesToken(string url, FirstSignature firstsignature) var request = (HttpWebRequest)WebRequest.Create(url); request.method = "POST"; request.contenttype = "application/json"; request.headers.add("authorization", string.format("basic 0", firstsignature.base64credentials)); request.headers.add("signature", firstsignature.signedsignature); request.headers.add("timestamp", string.format("0", firstsignature.timestamp)); return GetResponse(request); csn) /// Sets up the GetInvoice URL end-point, headers for the request and a particular CSN /// <param name="url">string that contains the GetInvoices end-point</param> /// <param name="secondsignature">class that contains a signed Access Token</param> /// <param name="csn">string that contains CSN</param> /// <returns>string with a JSON object</returns> public static string GetInvoices(string url, SecondSignature secondsignature, string var request = (HttpWebRequest)WebRequest.Create(url); request.method = "GET"; request.contenttype = "application/json"; request.headers.add("authorization", secondsignature.authorization); request.headers.add("csn", csn); request.headers.add("signature", secondsignature.signedsignature); request.headers.add("timestamp", string.format("0", secondsignature.timestamp)); return GetResponse(request); /// Gets a response from an Internet resource /// <param name="request">requet data </param> /// <returns>string with a JSON object</returns> 23 Manual de referencia del servicio web

24 public static string GetResponse(HttpWebRequest request) try var response = (HttpWebResponse)request.GetResponse(); var enc = System.Text.Encoding.GetEncoding("utf-8"); var responsestream = new StreamReader(response.GetResponseStream(), enc); var result = string.empty; result = responsestream.readtoend(); response.close(); return result; catch (Exception e) Trace.WriteLine(e.Message); return string.empty; /// Calls Invoices Endpoint and retrieves a list of invoices /// <param name="firstsignature">class that contains Partner's signed credentials</param> /// <returns>class with access token data</returns> public static AccessToken CallOAuthEndPoint(FirstSignature firstsignature) var url = " var details = Utils.GetAccesToken(url, firstsignature); var tokendetails = JsonConvert.DeserializeObject<AccessToken>(details); return tokendetails; /// Takes Partner's credentials and signs them /// <param name="credentials">class with partner's credentials data</param> /// <returns>class containing partner's signed credentials</returns> public static FirstSignature GetFirstSignature(Credentials credentials) var credtemp = string.format("0:1", credentials.consumerkey, credentials.consumersecret); var firstsignature = new FirstSignature Base64Credentials = Base64Encode(credTemp), Timestamp = GetEpochTimestamp() ; var message = string.format("012", credentials.basepath, credentials.consumerkey, firstsignature.timestamp); firstsignature.signedsignature = GenerateSignature(message, credentials.consumersecret); 24 Manual de referencia del servicio web

25 return firstsignature; /// Takes Access Token and signs it /// <param name="token">class with access token data</param> /// <param name="credentials">class with partner's credentials data</param> /// <returns>classs containing a signed access token</returns> public static SecondSignature GetSecondSignature(AccessToken token, Credentials credentials) var secondsignature = new SecondSignature Timestamp = GetEpochTimestamp(), CSN = credentials.csn, Authorization = string.format("bearer 0", token.access_token) ; var message = string.format("012", credentials.basepath, token.access_token, secondsignature.timestamp); secondsignature.signedsignature = GenerateSignature(message, credentials.consumersecret); return secondsignature; /// Encode string to base64 /// <param name="plaintext">string to be encoded</param> /// <returns>enconded string</returns> public static string Base64Encode(string plaintext) var plaintextbytes = System.Text.Encoding.UTF8.GetBytes(plainText); return System.Convert.ToBase64String(plainTextBytes); /// Decodes base64 string /// <param name="base64encodeddata">string to be decoded</param> /// <returns>decoded string</returns> public static string Base64Decode(string base64encodeddata) var base64encodedbytes = System.Convert.FromBase64String(base64EncodedData); return System.Text.Encoding.UTF8.GetString(base64EncodedBytes); /// Gets Epoch Unix timestamp /// <returns>epoch Unix timestamp</returns> public static int GetEpochTimestamp() return (int)(datetime.utcnow - new DateTime(1970, 1, 1)).TotalSeconds; 25 Manual de referencia del servicio web

26 /// Hashing of the signature using HMACSHA256 /// <param name="message">string with the message to be hashed</param> /// <param name="secret">string with the consumer secret</param> /// <returns>hashed string</returns> public static string GenerateSignature(string message, string secret) var encoding = new System.Text.ASCIIEncoding(); byte[] keybyte = encoding.getbytes(secret); byte[] messagebytes = encoding.getbytes(message); using (var hmacsha256 = new HMACSHA256(keyByte)) byte[] hashmessage = hmacsha256.computehash(messagebytes); return Convert.ToBase64String(hashmessage); /// Prints a JSON object to a file /// <param name="json">string with a JSON Object</param> public static void WriteJsonToFile(string json) using (System.IO.StreamWriter file = new System.IO.StreamWriter(@"C:\temp\json.txt")) file.writeline(json); POCO namespace MultipleInvoiceCallPoC /// Class used to store Access Token data public class AccessToken public string access_token get; set; public string expires_in get; set; public string token_type get; set; namespace MultipleInvoiceCallPoC.POCOs /// Class used to encapsulate the Partner's credentials data 26 Manual de referencia del servicio web

27 public class Credentials public string BasePath get; set; public string CSN get; set; public List<string> CSNs get; set; public string ConsumerKey get; set; public string ConsumerSecret get; set; namespace MultipleInvoiceCallPoC.POCOs /// Class used to encapsulate the Partner's signed credentials public class FirstSignature public string Base64Credentials get; set; public int Timestamp get; set; public string SignedSignature get; set; namespace MultipleInvoiceCallPoC.POCOs /// Class used to encapsulate a signed Access Token public class SecondSignature public string SignedSignature get; set; public int Timestamp get; set; public string Authorization get; set; public string CSN get; set; namespace MultipleInvoiceCallPoC.POCOs /// Class that represents an Invoice public class Invoice public string invoice_number get; set; public string purchase_order_number get; set; public string sales_order_number get; set; public string bill_to_customer get; set; public string invoice_date get; set; public string transaction_type get; set; public string invoice_total_amount get; set; public string invoice_currency get; set; public string account_doc_description get; set; public string customer_po_number get; set; 27 Manual de referencia del servicio web

28 /// Class used to contain Invoice data retreived from calling GetInvoices end-point public class InvoiceContainer public string status get; set; public string transaction_id get; set; public Invoice[] message get; set; /// Auxiliary class for display purposes used to contain Invoice data for a particular CSN public class ResponseContainer public string CSN get; set; public InvoiceContainer Responseget; set; Nota: Este Manual de referencia del servicio es para uso exclusivo de los destinatarios a los que se dirige y puede contener información propietaria o confidencial que puede ser información reservada o estar protegida frente a la divulgación. Queda totalmente prohibida cualquier revisión, uso, difusión o distribución no autorizados. 28 Manual de referencia del servicio web