Obtener la instrucción de recepción de factura

  • Artículo

Recupera un extracto de recibo de factura mediante el identificador de factura y el identificador de recibo.

Importante

Esta característica solo es aplicable a los recibos fiscales de Taiwán.

Requisitos previos

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.

  • Un identificador de factura válido y un identificador de recibo correspondiente.

C#

Para obtener un extracto de recibo de factura por identificador, a partir del SDK del Centro de partners v1.12.0, use la colección IPartner.Invoices y llame al método ById() mediante el identificador de factura, llame a la colección Receipts y llame a ById() y, a continuación, llame a los métodos Documents() y Statement() para acceder a la declaración de recibo de factura. Por último, llame a los métodos Get() o GetAsync().

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

var invoiceStatement = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Receipts.ById(selectedReceipt).Documents.Statement.Get();

Ejemplo: aplicación de prueba de consola. Project: PartnerSDK.FeatureSample (Clase): GetInvoiceReceiptStatement.cs

Solicitud REST

Sintaxis de la solicitud

Método URI de la solicitud
GET {baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

Parámetro de URI

Use el siguiente parámetro de consulta para obtener la instrucción de recibo de factura.

Nombre Tipo Obligatorio Descripción
invoice-id string Sí El valor es un identificador de factura que permite al revendedor filtrar los resultados de una factura determinada.
receipt-id string Sí El valor es un identificador de recibo que permite al revendedor filtrar los recibos de una factura determinada.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

None

Ejemplo de solicitud

GET https://api.partnercenter.microsoft.com/v1/invoices/<invoice-id>/receipts/<receipt-id>/documents/statement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 8ac25aa5-9537-4b6d-b782-aa0c8e979e99
MS-CorrelationId: 57eb2ca7-755f-450f-9187-eae1e75a0114

Respuesta REST

Si se ejecuta correctamente, este método devuelve una secuencia pdf en el cuerpo de la respuesta.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 195556
Content-Type: application/pdf
MS-CorrelationId: a1d6ab41-5a30-4643-898b-b30d65d3a0a1
MS-RequestId: cc1ba6db-ab26-404a-9196-712b6395f518
Date: Tue, 05 Feb 2019 04:08:23 GMT

{
    _content    {System.Net.Http.ByteArrayContent}    System.Net.Http.HttpContent {System.Net.Http.ByteArrayContent}
    _content    {byte[195556]}    byte[]
    _headers    {Content-Type: application/pdf Content-Disposition: attachment; filename=E-Tax-8602768.pdf}
}