Merge pull request #224 from FacturAPI/FAC-1822/document/verifying-cancellation-status

Add invoices cancellation guide and docs references

Author: javorosas

website/docs/guides/invoices/cancelaciones.mdx

@@ -70,6 +70,20 @@ invoice = facturapi.invoices.cancel('58e93bd8e86eb318b019743d', {
 })
 ```
 
+</TabItem>
+<TabItem value="cs" label="C#">
+
+```csharp
+var facturapi = new FacturapiClient("sk_test_API_KEY");
+var invoice = await facturapi.Invoice.CancelAsync(
+  "58e93bd8e86eb318b019743d",
+  new Dictionary<string, object>
+  {
+    ["motive"] = "02"
+  }
+);
+```
+
 </TabItem>
 </Tabs>
 
@@ -139,23 +153,29 @@ Cuando la cancelación es aceptada, puedes descargar el acuse en XML o PDF desde
 # Acuse en XML
 curl "https://www.facturapi.io/v2/invoices/58e93bd8e86eb318b019743d/cancellation_receipt/xml" \
   -H "Authorization: Bearer sk_test_API_KEY" \
-  -X GET
+  -X GET \
+  -o "acuse_cancelacion.xml"
 
 # Acuse en PDF
 curl "https://www.facturapi.io/v2/invoices/58e93bd8e86eb318b019743d/cancellation_receipt/pdf" \
   -H "Authorization: Bearer sk_test_API_KEY" \
-  -X GET
+  -X GET \
+  -o "acuse_cancelacion.pdf"
 ```
 
 </TabItem>
 <TabItem value="js" label="Node.js">
 
 ```javascript
 import Facturapi from 'facturapi';
+import fs from 'node:fs';
 const facturapi = new Facturapi('sk_test_API_KEY');
 
-await facturapi.invoices.downloadCancellationReceiptXml('58e93bd8e86eb318b019743d');
-await facturapi.invoices.downloadCancellationReceiptPdf('58e93bd8e86eb318b019743d');
+const xmlStream = await facturapi.invoices.downloadCancellationReceiptXml('58e93bd8e86eb318b019743d');
+xmlStream.pipe(fs.createWriteStream('acuse_cancelacion.xml'));
+
+const pdfStream = await facturapi.invoices.downloadCancellationReceiptPdf('58e93bd8e86eb318b019743d');
+pdfStream.pipe(fs.createWriteStream('acuse_cancelacion.pdf'));
 ```
 
 </TabItem>
@@ -165,8 +185,29 @@ await facturapi.invoices.downloadCancellationReceiptPdf('58e93bd8e86eb318b019743
 from facturapi import Facturapi
 
 facturapi = Facturapi('sk_test_API_KEY')
-facturapi.invoices.download_cancellation_receipt_xml('58e93bd8e86eb318b019743d')
-facturapi.invoices.download_cancellation_receipt_pdf('58e93bd8e86eb318b019743d')
+xml_stream = facturapi.invoices.download_cancellation_receipt_xml('58e93bd8e86eb318b019743d')
+with open('acuse_cancelacion.xml', 'wb') as file:
+    file.write(xml_stream.read())
+
+pdf_stream = facturapi.invoices.download_cancellation_receipt_pdf('58e93bd8e86eb318b019743d')
+with open('acuse_cancelacion.pdf', 'wb') as file:
+    file.write(pdf_stream.read())
+```
+
+</TabItem>
+<TabItem value="cs" label="C#">
+
+```csharp
+var facturapi = new FacturapiClient("sk_test_API_KEY");
+var xmlStream = await facturapi.Invoice.DownloadCancellationReceiptXmlAsync("58e93bd8e86eb318b019743d");
+var xmlFile = new System.IO.FileStream("C:\\route\\to\\save\\acuse_cancelacion.xml", FileMode.Create);
+xmlStream.CopyTo(xmlFile);
+xmlFile.Close();
+
+var pdfStream = await facturapi.Invoice.DownloadCancellationReceiptPdfAsync("58e93bd8e86eb318b019743d");
+var pdfFile = new System.IO.FileStream("C:\\route\\to\\save\\acuse_cancelacion.pdf", FileMode.Create);
+pdfStream.CopyTo(pdfFile);
+pdfFile.Close();
 ```
 
 </TabItem>

website/i18n/en/docusaurus-plugin-content-docs/current/guides/invoices/cancelaciones.mdx

@@ -70,6 +70,20 @@ invoice = facturapi.invoices.cancel('58e93bd8e86eb318b019743d', {
 })
 ```
 
+</TabItem>
+<TabItem value="cs" label="C#">
+
+```csharp
+var facturapi = new FacturapiClient("sk_test_API_KEY");
+var invoice = await facturapi.Invoice.CancelAsync(
+  "58e93bd8e86eb318b019743d",
+  new Dictionary<string, object>
+  {
+    ["motive"] = "02"
+  }
+);
+```
+
 </TabItem>
 </Tabs>
 
@@ -139,23 +153,29 @@ When the cancellation is accepted, you can download the cancellation receipt in
 # XML receipt
 curl "https://www.facturapi.io/v2/invoices/58e93bd8e86eb318b019743d/cancellation_receipt/xml" \
   -H "Authorization: Bearer sk_test_API_KEY" \
-  -X GET
+  -X GET \
+  -o "cancellation_receipt.xml"
 
 # PDF receipt
 curl "https://www.facturapi.io/v2/invoices/58e93bd8e86eb318b019743d/cancellation_receipt/pdf" \
   -H "Authorization: Bearer sk_test_API_KEY" \
-  -X GET
+  -X GET \
+  -o "cancellation_receipt.pdf"
 ```
 
 </TabItem>
 <TabItem value="js" label="Node.js">
 
 ```javascript
 import Facturapi from 'facturapi';
+import fs from 'node:fs';
 const facturapi = new Facturapi('sk_test_API_KEY');
 
-await facturapi.invoices.downloadCancellationReceiptXml('58e93bd8e86eb318b019743d');
-await facturapi.invoices.downloadCancellationReceiptPdf('58e93bd8e86eb318b019743d');
+const xmlStream = await facturapi.invoices.downloadCancellationReceiptXml('58e93bd8e86eb318b019743d');
+xmlStream.pipe(fs.createWriteStream('cancellation_receipt.xml'));
+
+const pdfStream = await facturapi.invoices.downloadCancellationReceiptPdf('58e93bd8e86eb318b019743d');
+pdfStream.pipe(fs.createWriteStream('cancellation_receipt.pdf'));
 ```
 
 </TabItem>
@@ -165,8 +185,29 @@ await facturapi.invoices.downloadCancellationReceiptPdf('58e93bd8e86eb318b019743
 from facturapi import Facturapi
 
 facturapi = Facturapi('sk_test_API_KEY')
-facturapi.invoices.download_cancellation_receipt_xml('58e93bd8e86eb318b019743d')
-facturapi.invoices.download_cancellation_receipt_pdf('58e93bd8e86eb318b019743d')
+xml_stream = facturapi.invoices.download_cancellation_receipt_xml('58e93bd8e86eb318b019743d')
+with open('cancellation_receipt.xml', 'wb') as file:
+    file.write(xml_stream.read())
+
+pdf_stream = facturapi.invoices.download_cancellation_receipt_pdf('58e93bd8e86eb318b019743d')
+with open('cancellation_receipt.pdf', 'wb') as file:
+    file.write(pdf_stream.read())
+```
+
+</TabItem>
+<TabItem value="cs" label="C#">
+
+```csharp
+var facturapi = new FacturapiClient("sk_test_API_KEY");
+var xmlStream = await facturapi.Invoice.DownloadCancellationReceiptXmlAsync("58e93bd8e86eb318b019743d");
+var xmlFile = new System.IO.FileStream("C:\\route\\to\\save\\cancellation_receipt.xml", FileMode.Create);
+xmlStream.CopyTo(xmlFile);
+xmlFile.Close();
+
+var pdfStream = await facturapi.Invoice.DownloadCancellationReceiptPdfAsync("58e93bd8e86eb318b019743d");
+var pdfFile = new System.IO.FileStream("C:\\route\\to\\save\\cancellation_receipt.pdf", FileMode.Create);
+pdfStream.CopyTo(pdfFile);
+pdfFile.Close();
 ```
 
 </TabItem>