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 factura de venta 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 factura de venta genérica.#

Footer#

Especificación y definición de datos del Footer de la factura de venta.

footerFV

1 - 8. Recargos y/o Descuentos (FV)
{
  "AllowanceCharges": [ 
    { 
        "ChargeIndicator": "false", //( 1 ) 
        "BaseAmount": "485000.00", 
        "ReasonCode": "00", 
        "Reason": "Discount", //( 2 ) 
        "Amount": "48500.00", //( 4 ) 
        "Percentage": "10", //( 3 ) 
        "SequenceIndicator": "1" 
    }, 
    { 
        "ChargeIndicator": "true", //( 5 ) 
        "BaseAmount": "485000.00", 
        "ReasonCode": "00", 
        "Reason": "fletes", //( 6 ) 
        "Amount": "58200.00", //( 8 ) 
        "Percentage": "12.00", //( 7 ) 
        "SequenceIndicator": "2" 
    } 
   ]
}
<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>
	<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><!-- ( 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. Retenciones (FV)
{
	"WithholdingTaxSubTotals": [
		{
			"WithholdingTaxCategory": "RETERENTA", //( 9 )
			"TaxPercentage": "4.0", //( 10 )
			"TaxableAmount": "485000.00", //( 11 )
			"TaxAmount": "19400.00"
		},
		{
			"WithholdingTaxCategory": "RETEIVA", //( 13 )
			"TaxPercentage": "15.0", //( 14 )
			"TaxableAmount": "92150.00", //( 15 )
			"TaxAmount": "13822.50" 
		},
		{
			"WithholdingTaxCategory": "RETEICA", //( 17 )
			"TaxPercentage": "11.04", //( 18 )
			"TaxableAmount": "485000.00", //( 19 )
			"TaxAmount": "53544.00"
		}
	],
	"WithholdingTaxTotals": [
		{
			"WithholdingTaxCategory": "RETERENTA",
			"TaxAmount": "19400.00" //( 12 ) 
		},
		{
			"WithholdingTaxCategory": "RETEIVA",
			"TaxAmount": "13822.50" //( 16 ) 
		},
		{
			"WithholdingTaxCategory": "RETEICA",
			"TaxAmount": "53544.00" //( 20 ) 
		}
	]
}
  <cac:WithholdingTaxTotal>
	<cbc:TaxAmount currencyID="COP">19400.00</cbc:TaxAmount><!-- ( 12 ) -->
    <cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00</cbc:TaxableAmount><!-- ( 11 )-->
        <cbc:TaxAmount currencyID="COP">19400.00</cbc:TaxAmount>
		<cbc:Percent>4.00</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>4.00</cbc:Percent><!-- ( 10 ) -->
            <cac:TaxScheme>
				<cbc:ID>06</cbc:ID>
				<cbc:Name>ReteRenta</cbc:Name><!-- ( 9 ) -->
            </cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:WithholdingTaxTotal>
<cac:WithholdingTaxTotal>
	<cbc:TaxAmount currencyID="COP">13822.50</cbc:TaxAmount><!-- ( 16 ) -->
    <cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">92150.00</cbc:TaxableAmount><!-- ( 15 ) -->
        <cbc:TaxAmount currencyID="COP">13822.50</cbc:TaxAmount>
		<cbc:Percent>15.00</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>15.00</cbc:Percent><!-- ( 14 ) -->
            <cac:TaxScheme>
				<cbc:ID>05</cbc:ID>
				<cbc:Name>ReteIVA</cbc:Name><!-- ( 13 ) -->
            </cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:WithholdingTaxTotal>
<cac:WithholdingTaxTotal>
	<cbc:TaxAmount currencyID="COP">53544.00</cbc:TaxAmount><!-- ( 20 ) -->
    <cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00</cbc:TaxableAmount><!-- ( 19 )-->
        <cbc:TaxAmount currencyID="COP">53544.00</cbc:TaxAmount>
		<cbc:Percent>11.04</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>11.04</cbc:Percent><!-- ( 18 ) -->
            <cac:TaxScheme>
				<cbc:ID>07</cbc:ID>
				<cbc:Name>ICA</cbc:Name><!-- ( 17 ) -->
            </cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:WithholdingTaxTotal>

Los códigos de las retenciones withholdingtaxes están disponibles en el método del WEB API de Saphety: WithHoldingTaxes.

  • 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- 32. Impuestos (FV)
{
	"TaxSubTotals": [
		{
			"TaxCategory": "IVA",//( 21 ) 
			"TaxPercentage": "19.00",//( 22 ) 
			"TaxableAmount": "485000.00",//( 23 ) 
			"TaxAmount": "92150.00"
		},
		{
			"TaxCategory": "INC",//( 25 )
			"TaxPercentage": "8.00",//( 26 )
			"TaxableAmount": "485000.00",//( 27 )
			"TaxAmount": "38800.00"
		},
		{
			"TaxCategory": "INCBolsas",//( 29 )
			"TaxPercentage": "0.00",
			"TaxAmount": "40.00",
			"PerUnitAmount": "40.00",//( 31 )
			"BaseUnitMeasure": "1",//( 30 )
			"BaseUnitMeasureUnitMeasure": "A31"
		}
	],
	"TaxTotals": [
		{
			"TaxCategory": "IVA",
			"TaxAmount": "92150.00",//( 24 ) 
			"RoundingAmount": "0.00"
		},
		{
			"TaxCategory": "INC",
			"TaxAmount": "38800.00",//( 28 ) 
			"RoundingAmount": "0.00"
		},
		{
			"TaxCategory": "incbolsas",
			"TaxAmount": "40.00",//( 32 ) 
			"RoundingAmount": "0.00"
		}
	]
}
  <cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount>
	<cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00</cbc:TaxableAmount><!-- ( 23 ) -->
        <cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount>
		<cbc:Percent>19.00</cbc:Percent>
		<cac:TaxCategory>
			<cbc:Percent>19.00</cbc:Percent> <!-- ( 22 ) -->
            <cac:TaxScheme>
				<cbc:ID>01</cbc:ID>
				<cbc:Name>IVA</cbc:Name> <!-- ( 21 ) -->
            </cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">38800.00</cbc:TaxAmount> <!-- ( 28 ) -->
    <cac:TaxSubtotal>
		<cbc:TaxableAmount currencyID="COP">485000.00</cbc:TaxableAmount><!-- ( 27 ) -->
        <cbc:TaxAmount currencyID="COP">38800.00</cbc:TaxAmount>
		<cbc:Percent>8.00</cbc:Percent> <!-- ( 26 ) -->
        <cac:TaxCategory>
			<cbc:Percent>8.00</cbc:Percent>
			<cac:TaxScheme>
				<cbc:ID>04</cbc:ID>
				<cbc:Name>INC</cbc:Name> <!-- ( 25 ) -->
            </cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">40.00</cbc:TaxAmount> <!-- ( 32 ) -->
    <cac:TaxSubtotal>
		<cbc:TaxAmount currencyID="COP">40.00</cbc:TaxAmount>
		<cbc:Percent>0.00</cbc:Percent>
		<cbc:BaseUnitMeasure unitCode="A31">1.00</cbc:BaseUnitMeasure> <!-- ( 30 ) -->
        <cbc:PerUnitAmount currencyID="COP">40.00</cbc:PerUnitAmount> <!-- ( 31 ) -->
        <cac:TaxCategory>
			<cbc:Percent>0.00</cbc:Percent>
			<cac:TaxScheme>
				<cbc:ID>22</cbc:ID>
				<cbc:Name>INCBolsas</cbc:Name> <!-- ( 29 ) -->
                </cac:TaxScheme>
		</cac:TaxCategory>
	</cac:TaxSubtotal>
</cac:TaxTotal>

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)

NA

33. Orden de Compra (FV)
{
  "DocumentReferences": [
    { 
        "DocumentReferred": "No. de Orden de Compra", //( 33 ) 
        "IssueDate": "2020-02-19T00:00:00", //( 33 ) 
        "Type": "OrderReference" 
    } ]
}
<cac:OrderReference>
	<cbc:ID>No. de Orden de Compra</cbc:ID><!-- ( 33 )  -->
	<cbc:IssueDate>2023-11-27</cbc:IssueDate><!-- ( 33 )  -->
</cac:OrderReference>

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

  • 33: 22 CARACTERES

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

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

  • 34: 22 CARACTERES

35 - 36. Aviso de Recibo (FV)
{
  "DocumentReferences": [
    { 
        "DocumentReferred": "No. de aviso de recibo", //( 35 ) 
        "IssueDate": "2020-02-19T00:00:00", //( 36 ) 
        "Type": "ReceiptReference" 
    } ]
}
<cac:ReceiptDocumentReference>
	<cbc:ID>No. de aviso de recibo</cbc:ID><!-- ( 35 )  -->
	<cbc:IssueDate>2023-11-27</cbc:IssueDate><!-- ( 36 )  -->
</cac:ReceiptDocumentReference>

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

  • 35: 22 CARACTERES

  • 36: 22 CARACTERES

37 - 38. Otra referencia (FV)
{
  "DocumentReferences": [ 
    { 
        "DocumentReferred": "No. de Otra referencia", //(37) 
        "IssueDate": "2020-04-21T00:00:00", //(38) 
        "Type": "OtherReference"
    } ]
}
  <cac:AdditionalDocumentReference>
	<cbc:ID>No. de Otra referencia</cbc:ID><!-- (37) --> 
    <cbc:IssueDate>2020-04-21</cbc:IssueDate><!-- (38) --> 
    <cbc:DocumentTypeCode/>
	<cbc:DocumentType/>
</cac:AdditionalDocumentReference>

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

  • 37: 22 CARACTERES

  • 38: 22 CARACTERES

39. Notas (FV)
{
  "Notes": [
    "IVA-Régimen Común, NO somos grandes contribuyentes, NO autorretenedores, Códigos de Actividad económica: 6202-Tarifa 6.9x1.000, 7490 - Tarifa 6.9x1.000, FAVOR CONSIGNAR A LA CUENTA CORRIENTE 051-03674-7 CORPBANCA, Tels: (571) 6167788 - 6167989 Fax: (571) 6115505"
    ]
}
  <cbc:Note>
  IVA-Régimen Común, NO somos grandes contribuyentes, NO autorretenedores, Códigos de Actividad económica: 6202-Tarifa 6.9x1.000, 7490 - Tarifa 6.9x1.000, FAVOR CONSIGNAR A LA CUENTA CORRIENTE 051-03674-7 CORPBANCA, Tels: (571) 6167788 - 6167989 Fax: (571) 6115505
  </cbc:Note>

NA

  • 560 CARACTERES 4 LÍNEAS

40. Código QR (FV)

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

  • Detalle: XPath

  • NumFac: [NUMERO_FACTURA] : /Invoice/cbc:ID

  • FecFac: [FECHA_FACTURA]: /Invoice/cbc:IssueDate

  • HorFac: [HORA_FACTURA(con GMT)] /Invoice/cbc:IssueTime

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

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

  • ValFac: [VALOR_FACTURA]: /Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount

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

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

  • ValTolFac: [VALOR_TOTAL_FACTURA] /Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount

  • CUFE: /Invoice/cbc:UUID

  • QRCode: /Invoice/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

41. CUFE (FV)

CUFE: Código Único de Facturación Electrónica, generado por la plataforma SaphetyDoc.

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

NA

NA

42. Texto Dinámico (FV)
{
    //Texto dinámico - Información sobre el Software: 
  "GraphicalRepresentationCustomFields": [
    {
        "Key": "fabricante_software",
        "Value": "Apellidos y nombre o razón social y Número de Identificación Tributaria -NIT, del fabricante del software, el nombre del software" 
    }]
}

NA

NA

  • 140 Caracteres con un tamaño de 7px para que quede en una sola línea.

43. Texto Estático (FV)

Texto Estático - Información sobre el Proveedor tecnológico: Apellidos y nombre o razón social y Número de Identificación Tributaria -NIT, del fabricante del Proveedor tecnológico.

NA

NA

NA

44. Datos Resolución de Numeración DIAN (FV)

Viene del sistema (Pre configurado en la plataforma SaphetyDoc.) Número de autorización (18760000001), Prefijo (SETT) Rango Autorizado: Desde (1) Hasta (5000000) y Vigencia Desde (2019-01-19) hasta (2030-01-19)

  <sts:InvoiceControl>
  <sts:InvoiceAuthorization>18760000001<sts:InvoiceAuthorization>
  <sts:AuthorizationPeriod>
  <cbc:StartDate>2019-12-09</cbc:StartDate>
  <cbc:EndDate>2021-12-09</cbc:EndDate>
  </sts:AuthorizationPeriod>
  <sts:AuthorizedInvoices>
  <sts:Prefix>SETT</sts:Prefix>
  <sts:From>1</sts:From>
  <sts:To>5000000</sts:To>
  </sts:AuthorizedInvoices>
  </sts:InvoiceControl>

NA

NA

45. Tasa de Cambio (FV)
{
  "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

46. Subtotal Base Gravable (FV)
{
  "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

47. Total Impuestos (FV)
{
	"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" //( 47 ) 
		},
		{
			"TaxCategory": "INC",
			"TaxAmount": "38800.00" //( 47 ) 
		},
		{
			"TaxCategory": "INCBOLSAS",
			"TaxAmount": "40.00" //( 47 ) 
		}
	]
}
  <cac:TaxTotal>
	<cbc:TaxAmount currencyID="COP">92150.00</cbc:TaxAmount><!--  ( 47 ) --> 
    <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><!-- ( 47 ) --> 
    <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> <!-- ( 45 ) --> 
    <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 factura.

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

48. Total mas Impuesto (FV)
{
  "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

49. Anticipos (FV)
{
	"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 factura.

  • El Valor a Pagar de Factura 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

50 - 51. Descuentos y Recargos Globales (FV)
{
	"AllowanceCharges": [
		{
			"ChargeIndicator": "false",
			"BaseAmount": "485000.00",
			"ReasonCode": "00",
			"Reason": "Discount",
			"Amount": "48500.00",
			"Percentage": "10",
			"SequenceIndicator": "1"
		},
		{
			"ChargeIndicator": "true",
			"BaseAmount": "485000.00",
			"ReasonCode": "00",
			"Reason": "fletes",
			"Amount": "58200.00",
			"Percentage": "12.00",
			"SequenceIndicator": "2"
		}
	],
	"Total": {
		"GrossAmount": "485000.00",
		"TotalBillableAmount": "615990.00",
		"PayableAmount": "575790.00",
		"TaxableAmount": "485000.00",
		"AllowancesTotalAmount": "48500.00",
		"ChargesTotalAmount": "58200.00",
		"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>
	<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>
	<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>
	<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>

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.

  • 50: 23 Dígitos incluidos separadores decimales

  • 51: 23 Dígitos incluidos separadores decimales

52. Valor Total de Operación (FV)
{
	"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 (FV)
{
  "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 Crédito de la Factura Electrónica de Venta

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

By Sovos-Saphety Colombia

© Copyright 2023.