Skip to main content
Ctrl+K
Documentación Saphety Colombia - Home Documentación Saphety Colombia - Home
  • Bienvenidos a nuestra guía técnica de integración con SOVOS-Saphety
  • Ecosistema de Documentos Electrónicos
    • Facturación Electrónica
      • Generación
      • Transmisión para la validación
      • Validación
      • Expedición de Factura Electrónica de Venta
    • Recepción Electrónica
    • Documento Soporte
      • Generación
      • Transmisión para la validación
      • Validación
      • Expedición de un Documento Soporte
    • Documento Equivalente
      • Generación
      • Transmisión para la validación
      • Validación
      • Expedición de un Documento Equivalente
    • Nómina Electrónica
      • Generación
      • Transmisión para la validación
      • Validación
      • Notificación de la Nómina
  • Emisión de Documentos
    • Entornos
    • Autenticación (Solicitar TOKEN)
    • Facturación Electrónica
      • Factura Electrónica de Venta
        • Representación Gráfica de Factura de Venta
        • Guía de Integración a Nivel Global (Header)
        • Guía de Integración a Nivel de Línea (Main)
        • Guía de Integración a Nivel Global (Footer)
      • Nota Crédito de la Factura Electrónica de Venta
        • Representación Gráfica de Nota Crédito
        • Guía de Integración a Nivel Global (Header)
        • Guía de Integración a Nivel de Línea (Main)
        • Guía de Integración a Nivel Global (Footer)
      • Nota Débito de la Factura Electrónica de Venta
        • Representación Gráfica de Nota Débito
        • Guía de Integración a Nivel Global (Header)
        • Guía de Integración a Nivel de Línea (Main)
        • Guía de Integración a Nivel Global (Footer)
      • Contingencia Tipo 3 para Factura de Venta Electronica
      • Consultar metadatos (CUFE/CUDE) de un documento de Facturación Electrónica
      • Consultar Estado de un documento de Facturación Electrónica
      • Descargar Formatos de los Documentos de Electrónicos
    • Documento Soporte Electrónico
      • Documento Soporte para No Obligados a Facturar
        • Representación Gráfica de Documento Soporte
        • Guía de Integración a Nivel Global (Header)
        • Guía de Integración a Nivel de Línea (Main)
        • Guía de Integración a Nivel Global (Footer)
      • Nota de Ajuste Documento Soporte
        • Representación Gráfica de Nota de Ajuste DS
        • Guía de Integración a Nivel Global (Header)
        • Guía de Integración a Nivel de Línea (Main)
        • Guía de Integración a Nivel Global (Footer)
      • Consultar metadatos (CUDS) de un Documento Soporte Electrónico
      • Consultar Estado de un Documento Soporte Electrónico
      • Descargar Formatos de los Documentos de Electrónicos
    • Documento Equivalente Electrónico
      • Documento Equivalente Tiquete P.O.S (Estándar)
        • Representación Gráfica de Documento Equivalente POS
        • Guía de Integración a Nivel Global (Header)
        • Guía de Integración a Nivel de Línea (Main)
        • Guía de Integración a Nivel Global (Footer)
      • Notas de Ajuste Documento Equivalente
        • Representación Gráfica de Nota de Ajuste
        • Guía de Integración a Nivel Global (Header)
        • Guía de Integración a Nivel de Línea (Main)
        • Guía de Integración a Nivel Global (Footer)
      • Consultar metadatos (CUDE) de un Documento Equivalente Electrónico
      • Consultar Estado de un Documento Equivalente Electrónico
      • Descargar Formatos de los Documentos de Electrónicos
    • Nómina Electrónica
      • Nómina Electrónica Individual
        • Representación Gráfica de Nómina Individual
        • Guía de Integración (Header NE)
        • Guía de Integración (Main)
        • Guía de Integración (Footer)
      • Nota Ajuste de Eliminación (Nómina)
        • Representación Gráfica de Nota de Ajuste de Eliminación
        • Guía de Integración Nota de Ajuste Eliminación
      • Nota Ajuste de Reemplazo (Nómina)
        • Representación Gráfica de Nota de Ajuste de Reemplazo
        • Guía de Integración Nota de Ajuste Reemplazo (Header)
        • Guía de Integración Nota de Ajuste Reemplazo (Main)
        • Guía de Integración Nota de Ajuste Reemplazo (Footer)
      • Consultar metadatos (CUNE) de una Nomina Electrónica
      • Consultar Estado de una Nómina Electrónica
      • Descargar Formatos de los Documentos de Nómina
  • Ejemplificaciones
    • Facturación Electrónica
      • AIU
      • MANDATO
      • TRANSPORTE
      • SECTOR SALUD
      • PERSONA NATURAL
      • CONSUMIDOR FINAL
      • PDF PERSONALIZADO
      • MUESTRAS COMERCIALES
      • CARGOS Y DESCUENTOS A NIVEL DE LINEA
      • CARGOS Y DESCUENTOS A NIVEL GLOBAL
      • ANTICIPO
      • EXCLUIDOS
      • EXENTOS
      • IMPUESTOS PORCENTUALES
      • IMPUESTOS NOMINALES
      • IMPUESTOS SALUDABLES
      • RETENCIÓN ICA
      • RETERENTA
      • RETENCIÓN IVA
      • REDONDEOS
      • EXPORTACIÓN
      • INFORMAR OTRA DIVISA
      • ADJUNTOS
      • CONTACTOS
      • REFERENCIAS
      • CORREOS ADICIONALES
      • PROPINAS
      • NOTA CRÉDITO SIN REFERENCIA A FACTURA
      • NOTA DÉBITO SIN REFERENCIA A FACTURA
    • Documento Equivalente
      • Consumidor Final
      • PDF PERSONALIZADO
      • Impuesto Saludable INPP - DE
      • Impuesto Saludable IBUA - DE
      • Impuesto Saludable ICUI - DE
      • Impuesto Saludable ADV - DE
      • Impuesto Consumo de Licores - DE
    • Documento Soporte
      • VENDEDOR NO RESIDENTE EN COLOMBIA
      • MONEDA DIFERENTE A COP
      • Servicios/Bienes acumulados por un mismo proveedor
      • Servicios/Bienes por operacion
      • DESCUENTOS A NIVEL DE LINEA
      • DESCUENTOS A NIVEL GLOBAL
      • RETENCIONES
      • IMPUESTOS
      • Nota de Ajuste con Diferente Moneda
  • Recepción de Documentos
    • Recepción Electrónica
      • Consultar Documentos Recibidos
      • Creación de Documentos de Recepción
      • Consultar Estado de Documentos Recibidos
      • Descargar Formatos de Documentos Recibidos
      • Acuse de Eventos en Recepción
        • Acuse de Recibo de un Documento
        • Acuse del Bien y/o Prestación del Servicio
        • Acuse Aceptación o Rechazo del bien y/o prestación del servicio
      • Descargar Application Response
  • Habilitación DIAN
    • Habilitación Facturación Electrónica
    • Habilitación Recepción Electrónica
    • Habilitación Documento Soporte Electrónico
    • Habilitación Documento Equivalente Electrónico
    • Habilitación Nómina Electrónica
  • Artefactos
    • Kit de integración (POSTMAN)
    • Como utilizar el Kit de integración
    • Swagger
  • Conoce nuestro BOT
  • .md

Guía de Integración a Nivel Global (Footer)

Contents

  • Información de impuestos, retenciones, descuentos y totales a nivel global de una Nota Crédito genérica.
    • Footer

Guía de Integración a Nivel Global (Footer)#

Información de impuestos, retenciones, descuentos y totales a nivel global de una Nota Crédito genérica.#

Footer#

Especificación y definición de datos del Footer de la Nota Crédito.

footerNC

1 - 8. Recargos y/o Descuentos (NC)
{
	"AllowanceCharges": [
		{
			"ChargeIndicator": "false",//( 1 ) 
			"BaseAmount": "485000.00",
			"ReasonCode": "00",
			"Reason": "Discount",//( 2 ) 
			"Amount": "48500.00",
			"Percentage": "10",//( 3 ) 
			"SequenceIndicator": "1"
		},
		{
			"ChargeIndicator": "true",//( 5 ) 
			"BaseAmount": "485000.00",
			"ReasonCode": "00",
			"Reason": "fletes",//( 6 ) 
			"Amount": "58200.00",
			"Percentage": "12.00",//( 7 ) 
			"SequenceIndicator": "2"
		}
	],
	"Total": {
		"GrossAmount": "485000.00",
		"TotalBillableAmount": "615990.00",
		"PayableAmount": "575790.00",
		"TaxableAmount": "485000.00",
		"AllowancesTotalAmount": "48500.00",//( 4 ) 
		"ChargesTotalAmount": "58200.00",//( 8 ) 
		"PrePaidTotalAmount": "49900.00"
	}
}
  <cac:AllowanceCharge>
	<cbc:ChargeIndicator>false</cbc:ChargeIndicator> <!-- ( 1 ) -->
	<cbc:AllowanceChargeReasonCode>00</cbc:AllowanceChargeReasonCode>
	<cbc:AllowanceChargeReason>Discount</cbc:AllowanceChargeReason> <!-- ( 2 )  -->
	<cbc:MultiplierFactorNumeric>10.00</cbc:MultiplierFactorNumeric> <!-- ( 3 ) --> 
	<cbc:SequenceNumeric>1</cbc:SequenceNumeric>
	<cbc:Amount currencyID="COP">48500.00</cbc:Amount> <!-- ( 4 )  -->
	<cbc:BaseAmount currencyID="COP">485000.00</cbc:BaseAmount>
</cac:AllowanceCharge>
<cac:AllowanceCharge>
	<cbc:ChargeIndicator>true</cbc:ChargeIndicator> <!-- ( 5 ) -->
	<cbc:AllowanceChargeReasonCode>00</cbc:AllowanceChargeReasonCode>
	<cbc:AllowanceChargeReason>fletes <!-- ( 6 ) -->
	</cbc:AllowanceChargeReason>
	<cbc:MultiplierFactorNumeric>12.00  <!-- ( 7 ) -->
	</cbc:MultiplierFactorNumeric>
	<cbc:SequenceNumeric>2</cbc:SequenceNumeric>
	<cbc:Amount currencyID="COP">58200.00</cbc:Amount> <!-- ( 8 )  -->
	<cbc:BaseAmount currencyID="COP">485000.00</cbc:BaseAmount>
</cac:AllowanceCharge>

Los códigos de las razones de descuentos allowancechargecodetypes están disponibles en el método del WEB API de Saphety: AllowanceChargeCodeTypes.
Descuento = false

  • Fromula: AllowancesTotalAmount** = AllowanceCharges.Amount → AllowanceCharges. Cuando el campo ChargeIndicator = False.

Cargo = true

  • Formula: ChargesTotalAmount = AllowanceCharges.Amount → AllowanceCharges. Cuando el campo ChargeIndicator = True.

  • 1: 16 Caracteres

  • 2: 11 Caracteres

  • 3: 8 Dígitos incluyendo los separadores

  • 4: 23 Dígitos incluyendo los separadores

9 - 20. Impuestos (NC)
{
	"TaxSubTotals": [
		{
			"TaxCategory": "IVA",//( 9 ) 
			"TaxPercentage": "19.00",//( 10 ) 
			"TaxableAmount": "485000.00",//( 11 ) 
			"TaxAmount": "92150.00"
		},
		{
			"TaxCategory": "INC",//( 13 )
			"TaxPercentage": "8.00",//( 14 )
			"TaxableAmount": "485000.00",//( 15 )
			"TaxAmount": "38800.00"
		},
		{
			"TaxCategory": "INCBolsas",//( 17 )
			"TaxPercentage": "0.00",
			"TaxAmount": "40.00",
			"PerUnitAmount": "40.00",//( 19 )
			"BaseUnitMeasure": "1",//( 18 )
			"BaseUnitMeasureUnitMeasure": "A31"
		}
	],
	"TaxTotals": [
		{
			"TaxCategory": "IVA",
			"TaxAmount": "92150.00",//( 12 ) 
			"RoundingAmount": "0.00"
		},
		{
			"TaxCategory": "INC",
			"TaxAmount": "38800.00",//( 16 ) 
			"RoundingAmount": "0.00"
		},
		{
			"TaxCategory": "incbolsas",
			"TaxAmount": "40.00",//( 20 ) 
			"RoundingAmount": "0.00"
		}
	], 
    "Total": { 
        "GrossAmount": "485000.00", 
        "TotalBillableAmount": "615990.00", 
        "PayableAmount": "575790.00", 
        "TaxableAmount": "485000.00", 
        "AllowancesTotalAmount": "48500.00", 
        "ChargesTotalAmount": "58200.00", 
        "PrePaidTotalAmount": "49900.00" 
        }
}
  <cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount> <!-- ( 12 ) --> 
	<cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00 <!-- ( 11 )  -->
		</cbc:TaxableAmount>
		<cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount>
		<cbc:Percent>19.00</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>19.00</cbc:Percent> <!-- ( 10 )  -->
			<cac:TaxScheme>
				<cbc:ID>01</cbc:ID>
				<cbc:Name>IVA</cbc:Name> <!-- ( 9 )  -->
				</cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">38800.00</cbc:TaxAmount> <!-- ( 16 )  -->
	<cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00 <!-- ( 15 ) --> 
		</cbc:TaxableAmount>
		<cbc:TaxAmount currencyID="COP">38800.00</cbc:TaxAmount>
		<cbc:Percent>8.00</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>8.00</cbc:Percent> <!-- ( 14 ) --> 
			<cac:TaxScheme>
				<cbc:ID>04</cbc:ID>
				<cbc:Name>INC</cbc:Name> <!-- ( 13 ) --> 
				</cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">40.00</cbc:TaxAmount> <!-- ( 20 ) --> 
	<cac:TaxSubtotal>
		<cbc:TaxAmount currencyID="COP">40.00</cbc:TaxAmount>
		<cbc:Percent>0.00</cbc:Percent>
		<cbc:BaseUnitMeasure unitCode="A31">1.00</cbc:BaseUnitMeasure> <!-- ( 18 ) --> 
		<cbc:PerUnitAmount currencyID="COP">40.00</cbc:PerUnitAmount> <!-- ( 19 ) --> 
		<cac:TaxCategory>
			<cbc:Percent>0.00</cbc:Percent>
			<cac:TaxScheme>
				<cbc:ID>22</cbc:ID>
				<cbc:Name>INCBolsas</cbc:Name> <!-- ( 17 ) --> 
				</cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
	<cbc:LineExtensionAmount currencyID="COP">485000.00 </cbc:LineExtensionAmount>
	<cbc:TaxExclusiveAmount currencyID="COP">485000.00 </cbc:TaxExclusiveAmount>
	<cbc:TaxInclusiveAmount currencyID="COP">615990.00 </cbc:TaxInclusiveAmount>
	<cbc:AllowanceTotalAmount currencyID="COP">48500.00 </cbc:AllowanceTotalAmount>
	<cbc:ChargeTotalAmount currencyID="COP">58200.00 </cbc:ChargeTotalAmount>
	<cbc:PrepaidAmount currencyID="COP">49900.00</cbc:PrepaidAmount>
	<cbc:PayableAmount currencyID="COP">575790.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>

TaxCategory: Identificador del tributo, el listado de los tipos de TaxCategory están disponibles en el método del WEB API de Saphety: TaxCategory.

TaxPercentage: Tarifa del tributo: En el caso de que el tributo sea un porcentaje del valor tributable: informar la tarifa (porcentaje) a ser aplicada a la base imponible.

TaxableAmount:

  • Formula: Impuesto a nivel global (TaxableAmount) = Sumatoria Valor neto de las líneas ∑(Lines.NetAmount).
    Nota:

  • Esta sumatoria debe reportarse agrupado por tipo de impuesto y porcentaje.

  • No se deben sumar las líneas que sean excluidos de IVA (Lines.ExcludeVat= true).

TaxAmount: Formula Valor del impuesto global (TaxAmount) = Base del impuesto global (TaxSubTotals.TaxableAmount) * Porcentaje del impuesto (TaxSubTotals.TaxPercentage).
Nota: Esta sumatoria debe reportarse agrupado por tipo de impuesto y porcentaje.

TaxAmount(TaxTotals):

  • Formula: Valor Total del impuesto global (TaxTotals.TaxAmount)= Sumatoria de todos los valores de todos los tipos de impuesto ∑(TaxSubTotals.TaxAmount).

RoundingAmount: RoundingAmount corresponde al Redondeo agregado al impuesto y es opcional su envío, en caso de no tener redondeo se envía con valor 0.

  • Rechazo Si: TaxTotal/RoundingAmount <> Sumatoria de ((TaxTotal.TaxSubtotal.TaxableAmount * TaxTotal/TaxSubtotal/TaxCategory/Percent) - TaxTotal/TaxSubtotal/TaxAmount)

  • 9: 25 Caracteres

  • 10: 8 Dígitos incluyendo los separadores

  • 11: 23 dígitos incluyendo los separadores

  • 12: 23 dígitos incluyendo los separadores

21 - 22 - 23. Referencia a Factura (NC)
{
  "DocumentReferred": "SETT1092",//( 21 ) 
  "IssueDate": "2019-09-20T00:00:00",//( 22 )
  "Type": "InvoiceReference", 
  "DocumentReferredCUFE":"b8e56cb103c14c56c51bd62e4917ab9d8d67fce0878fc275d8f22a91a7dd79786bcd8f6899eca5c179fb03850 dd9035c"//( 23 )
}
  <cac:BillingReference>
  <cac:InvoiceDocumentReference> 
  <cbc:ID>SETT1092</cbc:ID><!-- ( 21 )  -->
  <cbc:UUID schemeName="CUFE-SHA384">b8e56cb103c14c56c51bd62e4917ab9d8d67fce0878f c275d8f22a91a7dd79786bcd8f6899eca5c17 9fb03850dd9035c</cbc:UUID><!-- ( 23 )  -->
  <cbc:IssueDate>2019-09-20</cbc:IssueDate><!-- ( 22 ) -->
  </cac:InvoiceDocumentReference> 
  </cac:BillingReference>

Los Documentos de referencia docreferencetypes están disponibles en el método del WEB API de Saphety: DocRefenceTypes.

Nota: La factura que se referencia debe existir o generada previamente a la Nota crédito, tener en cuenta el tipo de operación es 20 cuando se informa la referencia de FV.

  • 21: 22 Caracteres

  • 22: 22 Caracteres

  • 23: 134 Caracteres

24 - 25. Orden de Compra (NC)
{
  "DocumentReferences": [ 
    { 
        "DocumentReferred": "No. O.Compra",//( 24 ) 
        "IssueDate": "2020-01-18T00:00:00",//( 25 ) 
        "Type": "OrderReference" 
        } ]
}
  <cac:OrderReference>
  <cbc:ID>No. O.Compra</cbc:ID><!-- ( 24 ) -->
  <cbc:UUID>No. O.Compra</cbc:UUID>
  <cbc:IssueDate>2019-01-18</cbc:IssueDate><!-- ( 25 ) -->
  </cac:OrderReference>

Los Documentos de referencia docreferencetypes están disponibles en el método del WEB API de Saphety: DocReferenceTypes

  • 24: 22 Caracteres

  • 25: 22 Caracteres

26 - 27. Aviso de Despacho (NC)
{
  "DocumentReferences": [
    { 
        "DocumentReferred": "Orden de despacho",//( 26 ) 
        "IssueDate": "2020-02-19T00:00:00",//( 27 ) 
        "Type": "DespatchReference" 
    }]
}
  <cac:DespatchDocumentReference>
  <cbc:ID>Orden de despacho</cbc:ID><!-- ( 26 )  -->
  <cbc:IssueDate>2020-02-19</cbc:IssueDate><!-- ( 27 ) --> 
  </cac:DespatchDocumentReference>

Los Documentos de referencia docreferencetypes están disponibles en el método del WEB API de Saphety: DocReferenceTypes

  • 26: 22 Caracteres

  • 27: 22 Caracteres

28 - 29. Aviso de Recibo (NC)
{
  "DocumentReferences": [ 
    { 
        "DocumentReferred": "Remisiones Nos.",//(28) 
        "IssueDate": "2020-03-20T00:00:00",//(29) 
        "Type": "ReceiptReference" 
    } ]
}
  <cac:ReceiptDocumentReference>
  <cbc:ID>Remisiones Nos.</cbc:ID>//( 28 ) 
  <cbc:IssueDate>2020-03-20</cbc:IssueDate>//( 29 ) 
  </cac:ReceiptDocumentReference>

Los Documentos de referencia docreferencetypes están disponibles en el método del WEB API de Saphety: DocReferenceTypes

  • 28: 22 Caracteres

  • 29: 22 Caracteres

30 - 31. Otra Referencia (NC)
{
  "DocumentReferences": [ 
    { 
        "DocumentReferred": "Otra referencia", //( 30 ) 
        "IssueDate": "2020-04-21T00:00:00", //( 31 ) 
        "Type": "OtherReference" 
    }]
}
  <cac:AdditionalDocumentReference>
  <cbc:ID>Otra referencia</cbc:ID> <!-- ( 30 ) --> 
  <cbc:IssueDate>2020-04-21</cbc:IssueDate><!-- ( 31 )  -->
  <cbc:DocumentTypeCode/>
  <cbc:DocumentType/>
  </cac:AdditionalDocumentReference>

Los Documentos de referencia docreferencetypes están disponibles en el método del WEB API de Saphety: DocReferenceTypes

  • 30: 22 Caracteres

  • 31: 22 Caracteres

32. Notas (NC)
{
  "Notes": [
    "IVA REGIMEN COMUN. AGENTES RETENEDORES DE IVA. GRAN CONTRIBUYENTE RES.DIAN No 000076 DE 01 DICIEMBRE 2016. SOMOS RESPONSABLES DE INDUSTRIA Y COMERCIO EN Y PUERTO LOPEZ. CODIGO CIIU ACTIVIDAD PRINCIPAL 4661."
    ]
}
  <cbc:Note> IVA REGIMEN COMUN. AGENTES RETENEDORES DE IVA. GRAN CONTRIBUYENTE RES.DIAN No 000076 DE 01 DICIEMBRE 2016 . SOMOS RESPONSABLES DE INDUSTRIA Y COMERCIO EN Y PUERTO LOPEZ. CODIGO CIIU ACTIVIDAD PRINCIPAL 4661.</cbc:Note>

NA

  • 565 Caracteres 4 líneas

33. Código QR (NC)

Código QR viene de sistema (Pre configurado en la plataforma SaphetyDoc).

  • Detalle: XPath

  • NumFac: [NUMERO_NC] : /CreditNote/cbc:ID

  • FecFac: [FECHA_NC]: /CreditNote/cbc:IssueDate

  • HorFac: [HORA_NC(con GMT)] /CreditNote/cbc:IssueTime

  • NitFac: [NIT FACTURADOR]:/CreditNote/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID

  • DocAdq: [NUMERO_ID_ADQUIRENTE]: /CreditNote/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme cbc:CompanyID

  • ValFac: [VALOR_NC]: /CreditNote/cac:LegalMonetaryTotal/cbc:LineExtensionAmount

  • ValIva: [VALOR_IVA] /CreditNote/cac:TaxTotal/cbc:TaxAmount Donde /CreditNote/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01

  • ValOtroIm: [VALOR_OTROS_IMPUESTOS] Sumatoria de /CreditNote/cac:TaxTotal[X]/cbc:TaxAmount[X] Donde /CreditNote cac:TaxTotal[X]/cac:TaxSubtotal[X]/cac:TaxCategory[X]/cac:TaxScheme[X]/cbc:ID[X] sea diferente a 01

  • ValTolFac: [VALOR_TOTAL_NC] /CreditNote/cac:LegalMonetaryTotal/cbc:PayableAmount

  • CUFE: /CreditNote/cbc:UUID QRCode: /CreditNote/ext:UBLExtensions[1]/ext:UBLExtension[1]/ext:ExtensionContent[1]/sts:DianExtensions[1]/sts:QRCode URL disponible por la DIAN

  • Ambiente Habilitación: https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=CUFE

  • Ambiente Producción: https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=CUFE

NA

NA

34. CUDE (NC)

CUDE: Código Único de Documento Electrónico, generado por la plataforma SaphetyDoc.

  <cbc:UUID 
  schemeID="2" schemeName="CUDE-SHA384">2588e4b62e48653d4518781a9156d12489a76e924dbdea03e239e3797bbd2ac2f5c34b23dc3b8de8cb292ebba2220288
  </cbc:UUID>

NA

NA

35. Tasa de Cambio (NC)
{
  "PaymentExchangeRate": {
    "OriginCurrency": "USD",
    "DestinyCurrency": "COP",
    "Rate": "2900",
    "Date": "2019-09-18"
    }
}
  <cac:PaymentExchangeRate>
	<cbc:SourceCurrencyCode>USD</cbc:SourceCurrencyCode>
	<cbc:SourceCurrencyBaseRate>1.00</cbc:SourceCurrencyBaseRate>
	<cbc:TargetCurrencyCode>COP</cbc:TargetCurrencyCode>
	<cbc:TargetCurrencyBaseRate>1.00</cbc:TargetCurrencyBaseRate>
	<cbc:CalculationRate>2900.00</cbc:CalculationRate>
	<cbc:Date>2019-09-18</cbc:Date>
  </cac:PaymentExchangeRate>

Grupo de campos para información relacionada con el tipo de Factura de Exportación: OriginCurrency debe ser la divisa a la cual se hace la conversión.DestinyCurrency, será la divisa base del documento, debe ser igual a la divisa especificada en el campo “Currency”.

Cuando es factura nacional con moneda diferente a COP el DestinyCurrency debe ser COP.

Los tipos de moneda Currency están disponibles en el método del WEB API de Saphety: Currency.

  • 23 Dígitos incluidos separadores decimales

36. Subtotal Base Gravable (NC)
{
  "Total": { 
    "GrossAmount": "485000.00", 
    "TotalBillableAmount": "615990.00", 
    "PayableAmount": "575790.00", 
    "TaxableAmount": "485000.00", 
    "AllowancesTotalAmount": "48500.00", 
    "ChargesTotalAmount": "58200.00", 
    "PrePaidTotalAmount": "49900.00" }
}
  <cac:LegalMonetaryTotal>
	<cbc:LineExtensionAmount currencyID="COP">485000.00 </cbc:LineExtensionAmount>
	<cbc:TaxExclusiveAmount currencyID="COP">485000.00 </cbc:TaxExclusiveAmount>
	<cbc:TaxInclusiveAmount currencyID="COP">615990.00 </cbc:TaxInclusiveAmount>
	<cbc:AllowanceTotalAmount currencyID="COP">48500.00 </cbc:AllowanceTotalAmount>
	<cbc:ChargeTotalAmount currencyID="COP">58200.00 </cbc:ChargeTotalAmount>
	<cbc:PrepaidAmount currencyID="COP">49900.00</cbc:PrepaidAmount>
	<cbc:PayableAmount currencyID="COP">575790.00</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>

GrossAmount: Formula de Total bruto global (GrossAmount) = Sumatoria de los valores netos de las líneas del detalle ∑ (Lines.NetAmount).

TotalBillableAmount: Total de Valor Bruto más tributos es igual a Valor Bruto de la factura que contienen el valor comercial más la Suma de los Tributos de todas las líneas de detalle.

  • Formula: TotalBillableAmount = Valor Bruto de la factura (GrossAmount) + Sumatoria valor total de los impuestos de las líneas ∑ (Line.TaxTotals.TaxAmount).

PayableAmount: El Valor a Pagar de la Factura es igual a la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total.

  • Formula: Valor a pagar Total (PayableAmount) = TotalBillableAmount – Descuentos Globales (AllowancesTotalAmount) + Cargos globales (ChargesTotalAmount).

TaxableAmount: Es la sumatoria de la base gravable para calcular los impuestos de los servicios/productos que sean grabados o exentos. Para los productos/servicios excluidos su base gravable es 0.

  • Formula: Impuesto a nivel global Total.TaxableAmount = ∑(TaxSubTotals.TaxableAmount) esto a nivel de factura.

  • 23 Dígitos incluidos separadores decimales

37. Total Impuestos (NC)
{
	"TaxSubTotals": [
		{
			"TaxCategory": "IVA",
			"TaxPercentage": "19.00",
			"TaxableAmount": "485000.00",
			"TaxAmount": "92150.00"
		},
		{
			"TaxCategory": "INC",
			"TaxPercentage": "8.00",
			"TaxableAmount": "485000.00",
			"TaxAmount": "38800.00"
		},
		{
			"TaxCategory": "INCBOLSAS",
			"TaxPercentage": "0.00",
			"TaxAmount": "40.00",
			"PerUnitAmount": "40.00",
			"BaseUnitMeasure": "1",
			"BaseUnitMeasureUnitMeasure": "A31"
		}
	],
	"TaxTotals": [
		{
			"TaxCategory": "IVA",
			"TaxAmount": "92150.00" //( 37 ) 
		},
		{
			"TaxCategory": "INC",
			"TaxAmount": "38800.00" //( 37 ) 
		},
		{
			"TaxCategory": "INCBOLSAS",
			"TaxAmount": "40.00" //( 37 ) 
		}
	]
}
  <cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount><!--  ( 37 ) --> 
    <cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00</cbc:TaxableAmount>
		<cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount>
		<cbc:Percent>19.00</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>19.00</cbc:Percent>
			<cac:TaxScheme>
				<cbc:ID>01</cbc:ID>
				<cbc:Name>IVA</cbc:Name>
			</cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">38800.00</cbc:TaxAmount><!-- ( 37 ) --> 
    <cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00</cbc:TaxableAmount>
		<cbc:TaxAmount currencyID="COP">38800.00</cbc:TaxAmount>
		<cbc:Percent>8.00</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>8.00</cbc:Percent>
			<cac:TaxScheme>
				<cbc:ID>04</cbc:ID>
				<cbc:Name>INC</cbc:Name>
			</cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">40.00</cbc:TaxAmount> <!-- ( 35 ) --> 
    <cac:TaxSubtotal>
		<cbc:TaxAmount currencyID="COP">40.00</cbc:TaxAmount>
		<cbc:Percent>0.00</cbc:Percent>
		<cbc:BaseUnitMeasure unitCode="A31">1.00</cbc:BaseUnitMeasure>
		<cbc:PerUnitAmount currencyID="COP">40.00</cbc:PerUnitAmount>
		<cac:TaxCategory>
			<cbc:Percent>0.00</cbc:Percent>
			<cac:TaxScheme>
				<cbc:ID>22</cbc:ID>
				<cbc:Name>INCBolsas</cbc:Name>
			</cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>

El listado de los tipos de TaxCategory están disponibles en el método del WEB API de Saphety: TaxCategory.

  • Formula: Total Impuestos=∑ (TaxTotals.TaxAmount) Sumatoria de todos los impuestos a nivel global de la NC.

RoundingAmount corresponde al Redondeo agregado al impuesto y debe ser enviado de forma obligatoria, en caso de no tener redondeo se envía con valor 0.

  • Rechazo Si: TaxTotal/RoundingAmount <> Sumatoria de ((TaxTotal.TaxSubtotal.TaxableAmount * TaxTotal/TaxSubtotal/TaxCategory/Percent) - TaxTotal/TaxSubtotal/TaxAmount)

  • 23 Dígitos incluidos separadores decimales

38. Total mas Impuesto (NC)
{
  "Total": { 
    "GrossAmount": "485000.00", 
    "TotalBillableAmount": "615990.00", 
    "PayableAmount": "575790.00", 
    "TaxableAmount": "485000.00", 
    "AllowancesTotalAmount": "48500.00", 
    "ChargesTotalAmount": "58200.00", 
    "PrePaidTotalAmount": "49900.00" 
    }
}
  <cac:LegalMonetaryTotal>
	<cbc:LineExtensionAmount currencyID="COP">485000.00 </cbc:LineExtensionAmount>
	<cbc:TaxExclusiveAmount currencyID="COP">485000.00 </cbc:TaxExclusiveAmount>
	<cbc:TaxInclusiveAmount currencyID="COP">615990.00 </cbc:TaxInclusiveAmount>
	<cbc:AllowanceTotalAmount currencyID="COP">48500.00 </cbc:AllowanceTotalAmount>
	<cbc:ChargeTotalAmount currencyID="COP">58200.00 </cbc:ChargeTotalAmount>
	<cbc:PrepaidAmount currencyID="COP">49900.00</cbc:PrepaidAmount>
	<cbc:PayableAmount currencyID="COP">575790.00</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>

Formula: TotalBillableAmount = GrossAmount + TaxTotals.TaxAmount

  • 23 Dígitos incluidos separadores decimales

39. Anticipos (NC)
{
	"PrepaidPayments": [
		{
			"PaidDate": "2020-02-18",
			"PaidAmount": "49900.00"
		}
	],
	"Total": {
		"GrossAmount": "485000.00",
		"TotalBillableAmount": "615990.00",
		"PayableAmount": "575790.00",
		"TaxableAmount": "485000.00",
		"AllowancesTotalAmount": "48500.00",
		"ChargesTotalAmount": "58200.00",
		"PrePaidTotalAmount": "49900.00"
	}
}
<cac:PrepaidPayment>
	<cbc:ID>12979375-cd3f-4eff-a8ca-a9a15435cca8</cbc:ID>
	<cbc:PaidAmount currencyID="COP">49900.00</cbc:PaidAmount>
	<cbc:PaidDate>2020-02-18</cbc:PaidDate>
</cac:PrepaidPayment>
<cac:LegalMonetaryTotal>
	<cbc:LineExtensionAmount currencyID="COP">485000.00 </cbc:LineExtensionAmount>
	<cbc:TaxExclusiveAmount currencyID="COP">485000.00 </cbc:TaxExclusiveAmount>
	<cbc:TaxInclusiveAmount currencyID="COP">615990.00 </cbc:TaxInclusiveAmount>
	<cbc:AllowanceTotalAmount currencyID="COP">48500.00 </cbc:AllowanceTotalAmount>
	<cbc:ChargeTotalAmount currencyID="COP">58200.00 </cbc:ChargeTotalAmount>
	<cbc:PrepaidAmount currencyID="COP">49900.00</cbc:PrepaidAmount>
	<cbc:PayableAmount currencyID="COP">575790.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>

El Valor del Anticipo Total es igual a la suma de todos los anticipos o prepagos globales aplicados al total de la NC.

  • El Valor a Pagar de NC es igual a la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total Total.

  • 23 Dígitos incluidos separadores decimales

40 - 41. Descuentos y Recargos Globales (NC)
{
	"AllowanceCharges": [
		{
			"ChargeIndicator": "false",
			"BaseAmount": "485000.00",
			"ReasonCode": "00",
			"Reason": "Discount",
			"Amount": "48500.00", //( 40 )
			"Percentage": "10",
			"SequenceIndicator": "1"
		},
		{
			"ChargeIndicator": "true",
			"BaseAmount": "485000.00",
			"ReasonCode": "00",
			"Reason": "fletes",
			"Amount": "58200.00", //( 41 )
			"Percentage": "12.00",
			"SequenceIndicator": "2"
		}
	],
	"Total": {
		"GrossAmount": "485000.00",
		"TotalBillableAmount": "615990.00",
		"PayableAmount": "575790.00",
		"TaxableAmount": "485000.00",
		"AllowancesTotalAmount": "48500.00", //( 40 )
		"ChargesTotalAmount": "58200.00", //( 41 )
		"PrePaidTotalAmount": "49900.00"
	}
}
<cac:AllowanceCharge>
	<cbc:ChargeIndicator>false</cbc:ChargeIndicator>
	<cbc:AllowanceChargeReasonCode>00</cbc:AllowanceChargeReasonCode>
	<cbc:AllowanceChargeReason>Discount</cbc:AllowanceChargeReason>
	<cbc:MultiplierFactorNumeric>10.00</cbc:MultiplierFactorNumeric>
	<cbc:SequenceNumeric>1</cbc:SequenceNumeric>
	<cbc:Amount currencyID="COP">48500.00</cbc:Amount> <!-- ( 40 ) --> 
	<cbc:BaseAmount currencyID="COP">485000.00</cbc:BaseAmount>
</cac:AllowanceCharge>
<cac:AllowanceCharge>
	<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
	<cbc:AllowanceChargeReasonCode>00</cbc:AllowanceChargeReasonCode>
	<cbc:AllowanceChargeReason>fletes</cbc:AllowanceChargeReason>
	<cbc:MultiplierFactorNumeric>12.00</cbc:MultiplierFactorNumeric>
	<cbc:SequenceNumeric>2</cbc:SequenceNumeric>
	<cbc:Amount currencyID="COP">58200.00</cbc:Amount> <!-- ( 41 ) --> 
	<cbc:BaseAmount currencyID="COP">485000.00</cbc:BaseAmount>
</cac:AllowanceCharge>
<cac:LegalMonetaryTotal>
	<cbc:LineExtensionAmount currencyID="COP">485000.00</cbc:LineExtensionAmount>
	<cbc:TaxExclusiveAmount currencyID="COP">485000.00</cbc:TaxExclusiveAmount>
	<cbc:TaxInclusiveAmount currencyID="COP">615990.00</cbc:TaxInclusiveAmount>
	<cbc:AllowanceTotalAmount currencyID="COP">48500.00</cbc:AllowanceTotalAmount> <!-- ( 40 ) --> 
	<cbc:ChargeTotalAmount currencyID="COP">58200.00</cbc:ChargeTotalAmount> <!-- ( 41 ) --> 
	<cbc:PrepaidAmount currencyID="COP">49900.00</cbc:PrepaidAmount>
	<cbc:PayableAmount currencyID="COP">575790.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>

Descuento = false

  • AllowancesTotalAmount = AllowanceCharges.Amount → AllowanceCharges.ChargeIndicator = False

Cargo = true

  • ChargesTotalAmount = AllowanceCharges.Amount → AllowanceCharges.ChargeIndicator = True
    Códigos de razones de descuentos allowancechargecodetypes están disponibles en el método WEB API de Saphety: AllowanceChargeCodeTypes.

  • 40: 23 Dígitos incluidos separadores decimales

  • 41: 23 Dígitos incluidos separadores decimales

42. Valor Total de Operación (NC)
{
	"Total": {
		"GrossAmount": "485000.00",
		"TotalBillableAmount": "615990.00",
		"PayableAmount": "575790.00",
		"TaxableAmount": "485000.00",
		"AllowancesTotalAmount": "48500.00",
		"ChargesTotalAmount": "58200.00",
		"PrePaidTotalAmount": "49900.00"
	}
}
  <cac:LegalMonetaryTotal>
	<cbc:LineExtensionAmount currencyID="COP">485000.00</cbc:LineExtensionAmount>
	<cbc:TaxExclusiveAmount currencyID="COP">485000.00</cbc:TaxExclusiveAmount>
	<cbc:TaxInclusiveAmount currencyID="COP">615990.00</cbc:TaxInclusiveAmount>
	<cbc:AllowanceTotalAmount currencyID="COP">48500.00</cbc:AllowanceTotalAmount>
	<cbc:ChargeTotalAmount currencyID="COP">58200.00</cbc:ChargeTotalAmount>
	<cbc:PrepaidAmount currencyID="COP">49900.00</cbc:PrepaidAmount>
	<cbc:PayableAmount currencyID="COP">575790.00</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>

Valor a pagar Total (PayableAmount) = Total de Valor Bruto más tributos (TotalBillableAmount) – Descuentos Globales (AllowancesTotalAmount) + Cargos globales (ChargesTotalAmount)

  • 23 Dígitos incluidos separadores decimales

#. PDF Data (NC)
{
  "PdfData": { 
    "Pdf": "BASE64" 
   }
}

NA

Codificar representación gráfica de formato PDF a Base64

NA

previous

Guía de Integración a Nivel de Línea (Main)

next

Nota Débito de la Factura Electrónica de Venta

Contents
  • Información de impuestos, retenciones, descuentos y totales a nivel global de una Nota Crédito genérica.
    • Footer

By Sovos-Saphety Colombia

© Copyright 2023.