API Endpoints

Emitir Nota de Crédito Electrónica (34)

post
https://sandbox.alanube.co/dom/v1/credit-notes

Emitir Nota de Crédito Electrónica (34)

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto JSON con la información de la Nota de Crédito Electrónica

company
object

Información de la compañía con la que se emitirá (diferente a la principal)

idDoc
object
required

Identificación del documento
Campo DGII <IdDoc>

sender
object
required

Emisor
Campo DGII <Emisor>

buyer
object

Receptor
Campo DGII <Comprador >

additionalInformation
object

Informaciones adicionales
Campo DGII <InformacionesAdicionales>

transport
object

Transporte
Campo DGII <Transporte>

totals
object
required

TOTALES
Campo DGII <Totales>

otherCurrency
object

Otra moneda encabezado
Campo DGII <OtraMoneda>

itemDetails
array of objects
required
length between 1 and 1000

Detalle ítem
Campo DGII <DetallesItem>

itemDetails*
integer
required

Línea que numera el ítem. Desde 1 a 1000 repeticiones.
Campo DGII <NumeroLinea>

itemCodeTable
array of objects
length ≤ 5

Se pueden incluir 5 repeticiones de pares código – valor. Incluye los dos campos siguientes:
Campo DGII <TablaCodigosItem>

itemCodeTable
integer
enum
required

Indica si el ítem es exento, si es gravado, o No facturable. Indicará las distintas tasas:
0: No Facturable
1: ITBIS 1 ítem gravado a ITBIS tasa1 (18%).
2: ITBIS 2 ítem gravado a ITBIS tasa2 (16%).
3: ITBIS 3 ítem gravado a ITBIS tasa3 (0%).
4: Exento (E)
Campo DGII <IndicadorFacturacion>

Allowed:
retention
object

Retención
Campo DGII <Retencion>

string
required
length ≤ 80

Nombre del producto o servicio.
Campo DGII <NombreItem>

integer
enum
required

Identifica si el ítem corresponde a Bien o Servicio.
1: Bien
2: Servicio
Campo DGII <IndicadorBienoServicio>

Allowed:
string
length ≤ 1000

Descripción Adicional del ítem.
Campo DGII <DescripcionItem>

number
required
0 to 10000000000000000

Cantidad del ítem 55
Campo DGII <CantidadItem>

integer
1 to 62

Indica la unidad de medida que está expresada la cantidad.
Validar con la tabla de unidad de medidas
Campo DGII <UnidadMedida>

number
0 to 10000000000000000

Cantidad para la unidad de medida de referencia (no se usa para el cálculo del Monto Ítem). Condicional a que el ítem esté gravado con códigos de impuestos adicionales entre 006-022 en la Tabla de Codificación Tipo de Impuestos Adicional. 56
Campo DGII <CantidadReferencia>

integer

Indica la unidad de medida de referencia. Condicional a que esté completado el campo Cantidad de referencia.
Validar con la tabla de unidad de medidas
Campo DGII <UnidadReferencia>

subquantityTable
array of objects
length ≤ 5

Se deberá incluir esta tabla para fines del cálculo de los impuestos selectivos al consumo a productos derivados de alcohol y cervezas y productos del tabaco y cigarrillos. Condicional a que exista código desde 006 hasta 039 según la ‘Tabla de Codificación Tipos de Impuestos Adicionales’. Se pueden incluir 5 repeticiones de pares cantidad – código. Incluye los dos campos siguientes:
Campo DGII <TablaSubcantidad >

subquantityTable
number
0 to 99

Corresponde al porcentaje de alcohol en el volumen de concentración total alcohólica por unidad de producto. Condicional a que el ítem esté gravado con códigos de impuestos adicionales 006 hasta 018 en la Tabla de Codificación Tipo de Impuestos Adicional (bebidas alcohólicas).
Campo DGII <GradosAlcohol >

number
0 to 10000000000000000

Precio unitario para la unidad de medida de referencia (no se usa para el cálculo del monto Total). Condicional a que el ítem esté gravado con códigos de impuestos adicionales desde 023 hasta 039 en la Tabla de Codificación Tipo de Impuestos Adicional.
Campo DGII <PrecioUnitarioReferencia >

date

Dato correspondiente a la fecha de elaboración del ítem.
Campo DGII <FechaElaboracion>

date

Dato correspondiente a la fecha de vencimiento del ítem.
Campo DGII <FechaVencimientoItem>

mining
object

MINERÍA. Condicional a que exista facturación relacionado al sector minería.
Campo DGII <Mineria>

number
required
0 to 1000000000000000000

Dato correspondiente al precio unitario del ítem.
Campo DGII <PrecioUnitarioItem>

number
0 to 10000000000000000

Totaliza todos los subdescuentos otorgados al ítem en montos. Condicional a que exista Monto Subdescuento.
Campo DGII <DescuentoMonto>

subDiscounts
array of objects
length ≤ 12

Condicional a que exista descuento en el ítem. Se pueden incluir 12 repeticiones. Incluye los tres campos siguientes:
Campo DGII <TablaSubDescuento >

subDiscounts
number
0 to 10000000000000000

Totaliza todos los Subrecargos otorgados al ítem en montos. Condicional a que exista Monto Subrecargo.
Campo DGII <RecargoMonto>

subSurcharge
array of objects
length ≤ 12

Condicional a que exista recargo en el ítem. Se pueden incluir 12 repeticiones de pares Tipo – Valor. Incluye los tres campos siguientes:
Campo DGII <TablaSubRecargo >

subSurcharge
additionalTaxes
array of objects
length ≤ 2

Se pueden incluir 2 repeticiones de códigos de impuesto.
Validar con la tabla de tipos de impuestos
Campo DGII <TablaImpuestoAdicional>

additionalTaxes
otherCurrencyDetail
object

Otra moneda detalle. Indicar precios en monedas alternativas.
Campo DGII <OtraMonedaDetalle>

number
required
0 to 10000000000000000

(Precio Unitario del ítem * Cantidad) – Monto Descuento + Monto Recargo
Campo DGII <MontoItem>

subtotals
array of objects
length ≤ 20

Subtotales
Campo DGII <Subtotales>

subtotals
discountsOrSurcharges
array of objects
length ≤ 20

Descuento o recargo
Campo DGII <DescuentosORecargos>

discountsOrSurcharges
pagination
array of objects
length between 2 and 100

En esta sección se indica la cantidad de páginas del e-CF en la Representación Impresa y cuales ítems estarán en cada una. Cada objeto deberá repetirse para el total de páginas especificadas. La sección paginación es condicional a que el e-CF contenga más de una página, es decir, si la RI contiene una sola página, no debe enviarse.

Campo DGII <Paginacion>

pagination
integer
≥ 0

Indica la numeración de la página que contiene los datos del e-CF al realizar una representación impresa, siempre y cuando sea mayor a una página.
Campo DGII <PaginaNo>

integer
≥ 0

Indica el no. de la línea de detalle del primer ítem que contiene la página. Condicional a que sea completado el campo Página No.
Campo DGII <NoLineaDesde>

integer
≥ 0

Indica el no. de la línea de detalle del último ítem que será incluido en la página. Condicional a que sea completado el campo No. Línea Desde.
Campo DGII <NoLineaHasta>

number
0 to 10000000000000000

Total de la suma de valores de monto gravado ITBIS a diferentes tasas, de las líneas correspondientes a la página que se indica. Condicional a que exista Subtotal Monto gravado1, y/o Subtotal Monto gravado 2 y/o Subtotal Monto gravado 3 Página.
Campo DGII <SubtotalMontoGravadoPagina>

number
0 to 10000000000000000

Total de la suma de valores de Ítems gravados asignados a ITBIS tasa 1 (tasa 18%), de las líneas correspondientes a la página que se indica, menos descuentos más recargos. 78 Condicional a que la página contenga algún ítem gravado a tasa ITBIS 1.
Campo DGII <SubtotalMontoGravado1Pagina>

number
0 to 10000000000000000

Total de la suma de valores de Ítems gravados asignados a ITBIS tasa 2 (tasa 16%), de las líneas correspondientes a la página que se indica, menos descuentos más recargos. Condicional a que la página contenga algún ítem gravado a tasa ITBIS 2.
Campo DGII <SubtotalMontoGravado2Pagina>

number
0 to 10000000000000000

Total de la suma de valores de Ítems gravados asignados a ITBIS tasa 3 (tasa 0), de las líneas correspondientes a la página que se indica, menos descuentos más recargos. Condicional a que la página contenga algún ítem gravado a tasa ITBIS 3.
Campo DGII <SubtotalMontoGravado3Pagina>

number
0 to 10000000000000000

Total de la suma de valores correspondientes a ítems exentos indicados en el no. de línea ‘Desde’ ‘Hasta’, de la página. Condicional a que en la página contenga algún ítem exento.
Campo DGII <SubtotalExentoPagina>

number
0 to 10000000000000000

Total de la suma de valores de Subtotal ITBIS 1, Subtotal ITBIS 2 y Subtotal ITBIS 3, a las diferentes tasas, de las líneas correspondientes a la página que se indica. Condicional a que exista Subtotal ITBIS 1, Subtotal ITBIS 2 y Subtotal ITBIS 3 Página.
Campo DGII <SubtotalItbisPagina>

number
0 to 10000000000000000

Valor numérico igual al subtotal monto gravado 1 por la tasa ITBIS 1, de la línea indicada en la página. Condicional a que exista Subtotal Monto Gravado tasa 1.
Campo DGII <SubtotalItbis1Pagina>

number
0 to 10000000000000000

Valor numérico igual al subtotal monto gravado 2 por la tasa ITBIS 2, de la línea indicada en la página. Condicional a que exista Subtotal Monto Gravado tasa 2.
Campo DGII <SubtotalItbis2Pagina>

number
0 to 10000000000000000

Valor numérico igual al subtotal monto gravado 3 por la tasa ITBIS 3, de la línea indicada en la página. Condicional a que exista Subtotal Monto Gravado tasa 3.
Campo DGII <SubtotalItbis3Pagina>

number
0 to 10000000000000000

Sumatoria de los campos del área Subtotal Impuesto Adicional. Condicional a que se complete campos del área Subtotal Impuesto Adicional.
Campo DGII <SubtotalImpuestoAdicionalPagina>

subtotalAdditionalTax
object

Subtotal impuesto adicional
Campo DGII <SubtotalImpuestoAdicional>

number
0 to 10000000000000000

Sumatoria de los campos Subtotal Monto Gravado Total Pagina, Subtotal Exento Pagina, Subtotal ITBIS Pagina y Subtotal Impuesto Adicional Pagina. Condicional a que se complete el campo Página No.
Campo DGII <MontoSubtotalPagina>

number
0 to 10000000000000000

Suma de todos los valores correspondientes a ítems no facturables, que estén indicados en el no. de línea ‘Desde’ ‘Hasta’, de la página. Condicional a que la página incluya ítems no facturables.
Campo DGII <SubtotalMontoNoFacturablePagina>

integer
≥ 0

Indica la numeración de la página que contiene los datos del e-CF al realizar una representación impresa, siempre y cuando sea mayor a una página.
Campo DGII <PaginaNo>

integer
≥ 0

Indica el no. de la línea de detalle del primer ítem que contiene la página. Condicional a que sea completado el campo Página No.
Campo DGII <NoLineaDesde>

integer
≥ 0

Indica el no. de la línea de detalle del último ítem que será incluido en la página. Condicional a que sea completado el campo No. Línea Desde.
Campo DGII <NoLineaHasta>

number
0 to 10000000000000000

Total de la suma de valores de monto gravado ITBIS a diferentes tasas, de las líneas correspondientes a la página que se indica. Condicional a que exista Subtotal Monto gravado1, y/o Subtotal Monto gravado 2 y/o Subtotal Monto gravado 3 Página.
Campo DGII <SubtotalMontoGravadoPagina>

number
0 to 10000000000000000

Total de la suma de valores de Ítems gravados asignados a ITBIS tasa 1 (tasa 18%), de las líneas correspondientes a la página que se indica, menos descuentos más recargos. 78 Condicional a que la página contenga algún ítem gravado a tasa ITBIS 1.
Campo DGII <SubtotalMontoGravado1Pagina>

number
0 to 10000000000000000

Total de la suma de valores de Ítems gravados asignados a ITBIS tasa 2 (tasa 16%), de las líneas correspondientes a la página que se indica, menos descuentos más recargos. Condicional a que la página contenga algún ítem gravado a tasa ITBIS 2.
Campo DGII <SubtotalMontoGravado2Pagina>

number
0 to 10000000000000000

Total de la suma de valores de Ítems gravados asignados a ITBIS tasa 3 (tasa 0), de las líneas correspondientes a la página que se indica, menos descuentos más recargos. Condicional a que la página contenga algún ítem gravado a tasa ITBIS 3.
Campo DGII <SubtotalMontoGravado3Pagina>

number
0 to 10000000000000000

Total de la suma de valores correspondientes a ítems exentos indicados en el no. de línea ‘Desde’ ‘Hasta’, de la página. Condicional a que en la página contenga algún ítem exento.
Campo DGII <SubtotalExentoPagina>

number
0 to 10000000000000000

Total de la suma de valores de Subtotal ITBIS 1, Subtotal ITBIS 2 y Subtotal ITBIS 3, a las diferentes tasas, de las líneas correspondientes a la página que se indica. Condicional a que exista Subtotal ITBIS 1, Subtotal ITBIS 2 y Subtotal ITBIS 3 Página.
Campo DGII <SubtotalItbisPagina>

number
0 to 10000000000000000

Valor numérico igual al subtotal monto gravado 1 por la tasa ITBIS 1, de la línea indicada en la página. Condicional a que exista Subtotal Monto Gravado tasa 1.
Campo DGII <SubtotalItbis1Pagina>

number
0 to 10000000000000000

Valor numérico igual al subtotal monto gravado 2 por la tasa ITBIS 2, de la línea indicada en la página. Condicional a que exista Subtotal Monto Gravado tasa 2.
Campo DGII <SubtotalItbis2Pagina>

number
0 to 10000000000000000

Valor numérico igual al subtotal monto gravado 3 por la tasa ITBIS 3, de la línea indicada en la página. Condicional a que exista Subtotal Monto Gravado tasa 3.
Campo DGII <SubtotalItbis3Pagina>

number
0 to 10000000000000000

Sumatoria de los campos del área Subtotal Impuesto Adicional. Condicional a que se complete campos del área Subtotal Impuesto Adicional.
Campo DGII <SubtotalImpuestoAdicionalPagina>

subtotalAdditionalTax
object

Subtotal impuesto adicional
Campo DGII <SubtotalImpuestoAdicional>

number
0 to 10000000000000000

Sumatoria de los campos Subtotal Monto Gravado Total Pagina, Subtotal Exento Pagina, Subtotal ITBIS Pagina y Subtotal Impuesto Adicional Pagina. Condicional a que se complete el campo Página No.
Campo DGII <MontoSubtotalPagina>

number
0 to 10000000000000000

Suma de todos los valores correspondientes a ítems no facturables, que estén indicados en el no. de línea ‘Desde’ ‘Hasta’, de la página. Condicional a que la página incluya ítems no facturables.
Campo DGII <SubtotalMontoNoFacturablePagina>

informationReference
object
required

Información de referencia.
Campo DGII <InformacionReferencia>

config
object

Configuración adicional del documento electrónico

Responses

Updated 7 months ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago