ALalanube
Facturas electrónicas

Emitir Factura de Consumo Electrónica (32)

Changed on

Emitir Factura de Consumo Electrónica (32)

NOTAS

  • Se debe tener en cuenta que este endpoint puede tener dos tipos de respuesta, una síncrona (de inmediata respuesta) cuando el total de la factura es menor a DOP$250.000 y otra asíncrona (que se debe esperar respuesta de la DGII) cuando el total de la factura es mayor o igual a DOP$250.000
  • En caso de errores de comunicación con la DGII durante una respuesta síncrona, recibiremos y procesaremos tu solicitud de manera asincrónica. Así, intentaremos el envío nuevamente cuando la DGII esté operativa
    • Obtendrás una respuesta con una propiedad llamada response donde vendrá la razón por la cual la entidad no pudo recibir el documento junto con el código de error
    {
  "response":[
    {
      "message":"The connection with DGII has timed out. We have scheduled your document for automatic transmission. Check it out in a moment",
      "code":"AEP2006"
    }
  ]
}
    • Para consultar el estado final del documento electrónico, se debe usar este endpoint. O en caso de tener los webhooks activados nosotros te notificaremos automáticamente
post/invoices

Request

  • Base URL
    https://sandbox.alanube.co/dom/v1
  • URL
    https://sandbox.alanube.co/dom/v1/invoices
  • Auth
    HTTP bearer

Request body

Example request

{
  "company": {
    "id": "01FVJ1528AQRBC7D6K2TGVE5S5"
  },
  "idDoc": {
    "encf": "E320000000005",
    "deferredDeliveryIndicator": 1,
    "taxAmountIndicator": 1,
    "incomeType": 1,
    "paymentDeadline": "1990-12-31",
    "paymentTerm": "72 horas",
    "paymentFormsTable": [
      {
        "paymentAmount": 24300
      }
    ],
    "bankPayment": "Banco estatal",
    "dateFrom": "1990-12-31",
    "dateUntil": "1990-12-31",
    "totalPages": 3
  },
  "sender": {
    "rnc": "133109124",
    "companyName": "Mi compañía",
    "tradename": "Mi compañía S.A.",
    "branchOffice": "Mi sucursal",
    "address": "30 De Marzo 9 Sd",
    "municipality": "020101",
    "province": "020000",
    "economicActivity": "Componenetes electrónicos",
    "sellerCode": "A10002121",
    "internalInvoiceNumber": "2023",
    "internalOrderNumber": "202",
    "saleArea": "Ventas",
    "saleRoute": "Principal",
    "additionalInformationIssuer": "Información adicional de emisor...",
    "stampDate": "1990-12-31"
  },
  "buyer": {
    "rnc": "133109124",
    "foreignIdentifier": "A125451008",
    "companyName": "Su compañía",
    "contact": "David Pérez",
    "address": "30 De Marzo 9 Sd",
    "municipality": "020101",
    "province": "020000",
    "deliverDate": "1990-12-31",
    "contactDelivery": "30 De Marzo 9 Sd",
    "deliveryAddress": "30 De Marzo 9 Sd",
    "additionalPhone": "333-222-2454",
    "purchaseOrderDate": "1990-12-31",
    "internalCode": "A0001212",
    "additionalInformation": "Informacion adicional del comprador..."
  },
  "additionalInformation": {
    "shippingDate": "1990-12-31",
    "shipmentNumber": "A24000000126",
    "referenceNumber": 1234,
    "grossWeight": 228,
    "netWeight": 227,
    "grossWeightUnit": 10,
    "unitNetWeight": 10,
    "bulkQuantity": 1000,
    "bulkUnit": 10,
    "bulkVolume": 1000,
    "unitVolume": 10
  },
  "transport": {
    "driver": "A20020",
    "transportDocument": 20020,
    "file": "AZ100200",
    "licensePlate": "ED00168",
    "transportationRoute": "Principal",
    "transportationZone": "Zona de transporte"
  },
  "totals": {
    "totalTaxedAmount": 4000,
    "i1AmountTaxed": 1000,
    "i2AmountTaxed": 1000,
    "i3AmountTaxed": 1000,
    "exemptAmount": 1000,
    "itbisS1": 18,
    "itbisS2": 16,
    "itbisTotal": 340,
    "itbis1Total": 180,
    "itbis2Total": 160,
    "additionalTaxAmount": 270,
    "additionalTaxes": [
      {
        "taxType": 6,
        "additionalTaxRate": 632.58,
        "selectiveTaxAmountSpecificConsumption": 24300,
        "amountSelectiveConsumptionTaxAdvalorem": 24300,
        "otherAdditionalTaxes": 24300
      }
    ],
    "totalAmount": 88757.68,
    "nonBillableAmount": 88757.68,
    "amountPeriod": 88757.68,
    "previousBalance": 88757.68,
    "amountAdvancePayment": 88757.68,
    "payValue": 2000
  },
  "otherCurrency": {
    "currencyType": "USD",
    "exchangeRate": 100.8,
    "totalTaxedAmountOtherCurrency": 2000,
    "amountTaxed1OtherCurrency": 2000,
    "amountTaxed2OtherCurrency": 2000,
    "amountTaxed3OtherCurrency": 2000,
    "exemptAmountOtherCurrency": 2000,
    "itbisTotalOtherCurrency": 2000,
    "itbis1TotalOtherCurrency": 2000,
    "itbis2TotalOtherCurrency": 2000,
    "itbis3TotalOtherCurrency": 2000,
    "additionalTaxAmountOtherCurrency": 2000,
    "additionalTaxesOtherCurrency": [
      {
        "taxTypeOtherCurrency": 6,
        "additionalTaxRateOtherCurrency": 632.58,
        "selectiveTaxAmountSpecificConsumptionOtherCurrency": 24300,
        "amountSelectiveConsumptionTaxAdvaloremOtherCurrency": 24300,
        "otherAdditionalTaxesOtherCurrency": 24300
      }
    ],
    "totalAmountOtherCurrency": 24300
  },
  "itemDetails": [
    {
      "lineNumber": 1,
      "itemCodeTable": [
        {
          "codeType": "Interna",
          "itemCode": "A001212"
        }
      ],
      "itemName": "Caja de madera",
      "itemDescription": "Fabricado con madera de arce canadience",
      "quantityItem": 24300,
      "quantityReference": 24300,
      "referenceUnit": 4,
      "subquantityTable": [
        {
          "subquantity": 24300,
          "codeSubquantity": 3
        }
      ],
      "unitPriceReference": 24300,
      "elaborationDate": "1990-12-31",
      "expirationDateItem": "1990-12-31",
      "mining": {
        "netWeightKilogram": 240.32,
        "netWeightMining": 240.32
      },
      "unitPriceItem": 24300,
      "discountAmount": 24300,
      "subDiscounts": [
        {
          "subDiscountAmount": 24300
        }
      ],
      "surchargeAmount": 24300,
      "subSurcharge": [
        {
          "subSurchargeAmount": 24300
        }
      ],
      "additionalTaxes": [
        {
          "taxType": 6
        }
      ],
      "otherCurrencyDetail": {
        "priceOtherCurrency": 24300,
        "discountOtherCurrency": 24300,
        "surchargeAnotherCurrency": 24300,
        "amountItemOtherCurrency": 24300
      },
      "itemAmount": 24300
    }
  ],
  "subtotals": [
    {
      "subTotalNumber": 1,
      "subtotalDescription": "Subtotal 1",
      "order": 1,
      "subTotalAmountTaxedTotal": 24300,
      "subTotalAmountTaxedI1": 24300,
      "subTotalAmountTaxedI2": 24300,
      "subTotalAmountTaxedI3": 24300,
      "itbisSubTotal": 24300,
      "itbis1SubTotal": 24300,
      "itbis2SubTotal": 24300,
      "itbis3SubTotal": 24300,
      "subTotalAdditionalTax": 24300,
      "subTotalExempt": 24300,
      "subTotalAmount": 24300,
      "lines": 1
    }
  ],
  "discountsOrSurcharges": [
    {
      "lineNumber": 1,
      "norma1007Indicator": 1,
      "descriptionDiscountOrSurcharge": "Descuendo por el día de la madre",
      "discountAmountOrSurcharge": 24300,
      "discountAmountOrSurchargeOtherCurrency": 24300,
      "indicatorBillingDiscountOrSurcharge": 1
    }
  ],
  "pagination": [
    {
      "pageNo": 1,
      "noLineFrom": 1,
      "noLineUntil": 1,
      "subtotalAmountTaxedPage": 24300,
      "subtotalAmountTaxed1Page": 24300,
      "subtotalAmountTaxed2Page": 24300,
      "subtotalAmountTaxed3Page": 24300,
      "exemptSubtotalPage": 24300,
      "itbisSubtotalPage": 24300,
      "itbis1SubtotalPage": 24300,
      "itbis2SubtotalPage": 24300,
      "itbis3SubtotalPage": 24300,
      "subtotalAdditionalTaxPage": 24300,
      "subtotalAdditionalTax": {
        "subtotalSelectiveTaxForSpecificConsumptionPage": 24300,
        "subtotalOtherTax": 24300
      },
      "subtotalAmountPage": 24300,
      "subtotalNonBillableAmountPage": 24300
    }
  ],
  "informationReference": {
    "rncOtherTaxpayer": "101212154",
    "ncfModifiedDate": "1990-12-31",
    "modificationCode": 4
  },
  "config": {
    "pdf": {
      "type": "generic",
      "note": "Nota de prueba"
    }
  }
}

Response

Éxito en la creación de una Factura de Consumo Electrónica

idstring ulid
stampDatestring date

Fecha de emisión

status'REGISTERED' | 'TO_SEND' | 'WAITING_RESPONSE' | 'TO_NOTIFY' | 'FINISHED'

Estado del documento electrónico

legalStatus'ACCEPTED' | 'ACCEPTED_WITH_OBSERVATIONS' | 'REJECTED'

Estado legal de la factura electrónica ante la DIAN

companyIdentificationstring

Identificación de la empresa empleadora

documentNumberstring

Número del documento electrónico

documentStampUrlstring uri

Url donde se puede consultar el estado del documento en la DGII

xmlstring uri

XML firmado de la factura de consumo

resumeXmlstring uri

XML del resumen firmado enviado a la DGII

pdfstring uri

Archivo PDF que contiene la representación impresa del documento electrónico generado

signatureDatestring date-time

Fecha de firma del documento electrónico

securityCodestring

Código de seguridad del documento electrónico

sequenceConsumedboolean

Número de secuencia consumido

Example response

{
  "id": "01G021Z3QSRZ58GSTBH7TPGD2J",
  "stampDate": "1990-12-31",
  "status": "FINISHED",
  "legalStatus": "ACCEPTED_WITH_OBSERVATIONS",
  "documentNumber": "E310000001727",
  "documentStampUrl": "https://fc.dgii.gov.do/testecf/ConsultaTimbreFC?RncEmisor=132109122&ENCF=E320000001001&MontoTotal=29500&CodigoSeguridad=DJOULN",
  "xml": "https://api-alanube-e-provider-dom-test.s3.amazonaws.com/users/baa08af2-5924-4892-8554-0fe8ef561ab8/companies/f92f1ec0-80eb-4873-b06a-57534c678a04/invoice/01G02X48J00NBR7GY1DMJ7CJXP.xml?AWSAccessKeyId=ASI...&Expires=1649368860&Signature=QB7y...&x-amz-security-token=IQoJb3J...",
  "resumeXml": "https://api-alanube-e-provider-dom-test.s3.amazonaws.com/users/baa08af2-5924-4892-8554-0fe8ef561ab8/companies/f92f1ec0-80eb-4873-b06a-57534c678a04/invoice/01G0C48DFD8ARCQ7D0PDXTYX9H_resume.xml?AWSAccessKeyId=ASIA4...&Expires=1649678280&Signature=QN7r9...&x-amz-security-token=IQoJ...",
  "pdf": "https://api-alanube-e-provider-dom-test.s3.amazonaws.com/users/baa08af2-5924-4892-8554-0fe8ef561ab8/companies/f92f1ec0-80eb-4873-b06a-57534c678a04/fiscalInvoice/pdf/01G02X48J00NBR7GY1DMJ7CJXP.pdf?AWSAccessKeyId=ASI...&Expires=1649368860&Signature=QB7y...&response-content-disposition=attachment%3Bfilename%3DE310000001782.pdf&x-amz-security-token=IQoJb3J...",
  "securityCode": "MYUVCT",
  "sequenceConsumed": true,
  "governmentResponse": {
    "value": [
      {
        "valor": "El campo MontoGravadoI1 del área Totales de la sección Encabezado no coincide con la sumatoria de los valores del detalle gravado con tasa 18% menos descuentos mas recargos.",
        "codigo": 1934
      }
    ],
    "code": 4
  },
  "response": [
    {
      "code": "AEP2006",
      "message": "Documento recibido por la DGII de forma asincrona"
    }
  ]
}

Changes