Eventos

036 Inscripción

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del evento	N	3	036
description	✓	Texto que describe la Inscripción	A	0-500
operationType	✓	Código de Inscripción 361 = Primera inscripción de la factura electrónica de venta como título valor para Negociación General 362 = Primera inscripción de la factura electrónica de venta como título valor para NegociaciónDirecta Previa 363 = Inscripción posterior de la factura electrónica de venta como título valor para Negociación General 364 = Inscripción posterior de la factura electrónica de venta como título valor para Negociación Directa Previa	N	3
IDEmisor	✓	NIT del Emisor de la factura electrónica a inscribir	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Emisor de la factura electrónica a inscribir	N	2
NombreEmisor	✓	Nombre del Emisor de la factura electrónica a inscribir	A	5-450
IDEndosatario	C	NIT del Endosatario [!badge variant="dark" text="cuando el operationType es = a 362 o 364"].	N	3-13
NombreEndosatario	C	Nombre del Endosatario [!badge variant="dark" text="cuando el operationType es = a 362 o 364"]	A	5-450
valuePaid	✓	Valor pagado por receptor de Inscripción. Puede ser 0.	N	1-20
valueInvoice	✓	Valor total de la factura electrónica a inscribir.	N	1-20
InvoiceID	✓	ID de la factura electrónica a inscribir	A	50
docType	✓	Tipo de la factura electrónica a inscribir	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica a inscribir	A	96
IssueDate	✓	Fecha de emisón de la factura electrónica a inscribir	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a inscribir	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 036 tipo 361.

{
    "status":"036",
    "description":"Inscripcion",
    "operationType":"361",
    "valuePaid":"0",
    "valueInvoice":"432000",
    "IDEmisor":"900508908",
    "IDEmisorTipo":"31",
    "NombreEmisor":"Signature South Consulting",
    "InvoiceID":"SETP994002551",
    "docType":"01",
    "CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
    "IssueDate":"2022-12-05",
    "EndDateInvoice":"2022-12-30"
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 036 tipo 362.

{
    "status":"036",
    "description":"Inscripcion",
    "operationType":"362",
    "valuePaid":"0",
    "valueInvoice":"432000",
    "IDEmisor":"900508908",
    "IDEmisorTipo":"31",
    "NombreEmisor":"Signature South Consulting",
    "IDEndosatario":"890900608",
    "NombreEndosatario":"Éxito Viajes y Turismo",
    "InvoiceID":"SETP994002551",
    "docType":"01",
    "CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
    "IssueDate":"2022-12-05",
    "EndDateInvoice":"2022-12-30"
}

037 Endoso en Propiedad

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del Endoso	N	3	037
description	✓	Texto que describe el Endoso	A	0-500
operationType	✓	Código del Endoso 371 = Endoso con responsabilidad del endosante 372 = Endoso sin responsabilidad del endosante	N	3
IDEmisor	C	NIT del Emisor del Endoso	N	3-13
IDEmisorTipo	C	Tipo de identificación del Emisor del Endoso	N	2
NombreEmisor	C	Nombre del Emisor del Endoso	A	5-450
IDEndosatario	✓	NIT del Receptor del Endoso	N	3-13
NombreEndosatario	✓	Nombre del Receptor del Endoso	A	5-450
TipoEndoso	✓	Tipo de identificación del Endoso 1 = Completo - Endoso es el que figura la fecha, nombre y firma del Endosante, y nombre y numero de documento del Endosatario 2 = En blanco - Endoso que contiene la firma del Endosante y el numero de documento de identificacion del Endosatario	N	1
TipoFactor	C	Se debe informar el elemento cuando el endoso es generado hacia un Factor 1 = Factoring 2 = Confirming	N	1
valuePaid	✓	Valor pagado por receptor de Endoso	N	1-20
valueInvoice	✓	Valor total de la factura electrónica a endosar	N	1-20
PrecioPagarseEndoso	✓	Precio a pagar de la factura electrónica a endosar	N	1-20
TasaDescuentoEndoso	✓	Tasa de descuento del endoso	N	0-7
MedioPago	✓	Medio de pago del endoso	N	1-3
Moneda	✓	Tipo moneda de la factura electrónica a endosar	N	3
InvoiceID	✓	ID de la factura electrónica a endosar	A	50
docType	✓	Tipo de la factura electrónica a endosar	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica a endosar	A	96
IDReceptor	✓	NIT del Receptor de la factura electrónica a endosar	N	3-13
IDReceptorTipo	✓	Tipo de identificación del Receptor de la factura electrónica a endosar	N	2
NombreReceptor	✓	Nombre del Receptor de la factura electrónica a endosar	A	5-450
IssueDate	✓	Fecha de emisón de la factura electrónica a endosar	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a endosar	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un 037 tipo 371 y Tipo de Endoso = 1.

{
"status":"037",
"description":"Endoso en Propiedad",
"operationType":"371",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c417d6b2258240bd3119d485120b07",
"IDReceptor":"890900",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 037 tipo 371 y Tipo de Endoso = 2.

{
"status":"037",
"description":"Endoso en Propiedad",
"operationType":"371",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"2",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

038 Endoso en Garantía

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del Endoso	N	3	038
description	✓	Texto que describe el Endoso	A	0-500
operationType	✓	Código del Endoso	N	3	038
IDEmisor	C	NIT del Emisor del Endoso	N	3-13
IDEmisorTipo	C	Tipo de identificación del Emisor del Endoso	N	2
NombreEmisor	C	Nombre del Emisor del Endoso	A	5-450
IDEndosatario	✓	NIT del Receptor del Endoso	N	3-13
NombreEndosatario	✓	Nombre del Receptor del Endoso	A	5-450
TipoEndoso	✓	Tipo de identificación del Endoso 1 = Completo - Endoso es el que figura la fecha, nombre y firma del Endosante, y nombre y numero de documento del Endosatario 2 = En blanco - Endoso que contiene la firma del Endosante y el numero de documento de identificacion del Endosatario	N	1
valuePaid	✓	Valor pagado por receptor de Endoso	N	1-20
valueInvoice	✓	Valor total de la factura electrónica a endosar	N	1-20
PrecioPagarseEndoso	✓	Precio a pagar de la factura electrónica a endosar	N	1-20
TasaDescuentoEndoso	✓	Tasa de descuento del endoso	N	0-7
MedioPago	✓	Medio de pago del endoso	N	1-3
Moneda	✓	Tipo moneda de la factura electrónica a endosar	N	3
InvoiceID	✓	ID de la factura electrónica a endosar	A	50
docType	✓	Tipo de la factura electrónica a endosar	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica a endosar	A	96
IDReceptor	✓	NIT del Receptor de la factura electrónica a endosar	N	3-13
IDReceptorTipo	✓	Tipo de identificación del Receptor de la factura electrónica a endosar	N	2
NombreReceptor	✓	Nombre del Receptor de la factura electrónica a endosar	A	5-450
IssueDate	✓	Fecha de emisón de la factura electrónica a endosar	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a endosar	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 038 y Tipo de Endoso = 1.

{
"status":"038",
"description":"Endoso en Garantía",
"operationType":"038",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c417d6b2258240bd3119d485120b07",
"IDReceptor":"890900",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 038 y Tipo de Endoso = 2.

{
"status":"038",
"description":"Endoso en Garantía",
"operationType":"038",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"2",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

039 Endoso en Procuración

Estructura Json

Estructura petición Json:

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del Endoso	N	3	039
description	✓	Texto que describe el Endoso	A	0-500
operationType	✓	Código del Endoso	N	3	039
IDEmisor	C	NIT del Emisor del Endoso	N	3-13
IDEmisorTipo	C	Tipo de identificación del Emisor del Endoso	N	2
NombreEmisor	C	Nombre del Emisor del Endoso	A	5-450
IDEndosatario	✓	NIT del Receptor del Endoso	N	3-13
NombreEndosatario	✓	Nombre del Receptor del Endoso	A	5-450
TipoEndoso	✓	Tipo de identificación del Endoso 1 = Completo - Endoso es el que figura la fecha, nombre y firma del Endosante, y nombre y numero de documento del Endosatario 2 = En blanco - Endoso que contiene la firma del Endosante y el numero de documento de identificacion del Endosatario	N	1
valuePaid	✓	Valor pagado por receptor de Endoso	N	1-20
valueInvoice	✓	Valor total de la factura electrónica a endosar	N	1-20
PrecioPagarseEndoso	✓	Precio a pagar de la factura electrónica a endosar	N	1-20
TasaDescuentoEndoso	✓	Tasa de descuento del endoso	N	0-7
MedioPago	✓	Medio de pago del endoso	N	1-3
Moneda	✓	Tipo moneda de la factura electrónica a endosar	N	3
InvoiceID	✓	ID de la factura electrónica a endosar	A	50
docType	✓	Tipo de la factura electrónica a endosar	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica a endosar	A	96
IDReceptor	✓	NIT del Receptor de la factura electrónica a endosar	N	3-13
IDReceptorTipo	✓	Tipo de identificación del Receptor de la factura electrónica a endosar	N	2
NombreReceptor	✓	Nombre del Receptor de la factura electrónica a endosar	A	5-450
IssueDate	✓	Fecha de emisón de la factura electrónica a endosar	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a endosar	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 039 y Tipo de Endoso = 1.

{
"status":"039",
"description":"Endoso en Procuracion",
"operationType":"039",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c417d6b2258240bd3119d485120b07",
"IDReceptor":"890900",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un "evento 039 y Tipo de Endoso = 2.

{
"status":"039",
"description":"Endoso en Procuracion",
"operationType":"039",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"2",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

040 Cancelación de Endoso

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del Endoso	N	3	040
operationType	✓	Tipo de Cancelación de Endoso 401 = Cancelación de Endoso en Garantía 402 = Cancelación de Endoso en Procuracióno	N	3
IDEmisor	✓	NIT del Emisor de la Cancelación	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Emisor de la Cancelación	N	2
NombreEmisor	✓	Nombre del Emisor de la Cancelación	A	5-450
IDEndosatario	✓	NIT del Receptor del Endoso	N	3-13
NombreEndosatario	✓	Nombre del Receptor del Endoso	A	5-450
TipoEndoso	✓	Tipo de identificación del Endoso a Cancelar 038 = Endoso en Garantía 039 = Endoso en Procuración	N	3
IDEndoso	✓	ID de la factura electrónica a endosar	A	50
CUDEEndoso	✓	CUFE de la factura electrónica a endosar	A	96
Motivo	C	Motivo por el cual se cancela el Endoso. Aplica solo para cancelar un Endoso en Procuración tipo 038	A	0-500
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a endosar	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 040 cancelando Endoso en Garantía 038.

{
"status":"040",
"operationType":"401",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"038",
"IDEndoso":"5809181359",
"CUDEEndoso":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"EndDateInvoice":"2022-12-30"
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 040 cancelando Endoso en Procuración 039.

{
"status":"040",
"operationType":"402",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"039",
"IDEndoso":"5809181359",
"CUDEEndoso":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"Motivo":"error",
"EndDateInvoice":"2022-12-30"
}

045 Pago

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del evento	N	3	045
operationType	✓	Tipo de Pago de la factura electrónica de venta como título valor 451 = Pago parcial de la factura electrónica de venta como título valor 452 = Pago total de la factura electrónica de venta como título valor	N	3
IDEmisor	✓	NIT del Emisor del Pago	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Pago	N	2
NombreEmisor	✓	Nombre del Emisor del Pago	A	5-450
TipoPago	✓	Tipo de identificación del Pago 1 = Sin limitación - Pago de la factura sin limitación 2 = Con limitación - Pago de la factura con limitación	N	1
ValorActualTituloValor	✓	Valor actual del titulo valor	N	1-20
ValorPendienteTituloValor	✓	Saldo insoluto del valor total a la fecha de este pago	N	1-20
ValorPagado	✓	Valor Pagado sobre el valor total de la FEV o Titulo Valor	N	1-20
InvoiceID	✓	ID de la factura electrónica título valor	A	50
docType	✓	Tipo de la factura electrónica título valor	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica título valor	A	96
FechaPago	✓	Fecha de pago de la factura electrónica título valor	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a inscribir	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 045 Pago parcial tipo 451.

{
"status":"045",
"operationType":"451",
"description":"Pago de factura",
"IDEmisor":"890900608",
"IDEmisorTipo":"31",
"NombreEmisor":"ALMACENES EXITO S A",
"TipoPago":"1",
"ValorActualTituloValor":"400000",
"ValorPendienteTituloValor":"32000",
"ValorPagado":"432000",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"FechaPago":"2023-01-03",
"EndDateInvoice":"2022-12-30"
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 045 Pago total tipo 452.

{
"status":"045",
"operationType":"452",
"description":"Pago de factura",
"IDEmisor":"890900608",
"IDEmisorTipo":"31",
"NombreEmisor":"ALMACENES EXITO S A",
"TipoPago":"1",
"ValorActualTituloValor":"432000",
"ValorPendienteTituloValor":"0",
"ValorPagado":"432000",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"FechaPago":"2023-01-03",
"EndDateInvoice":"2022-12-30"
}

046 Informe para Pago

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del evento	N	3	046
description	✓	Texto que describe el evento	A	0-500
IDEmisor	✓	NIT del Emisor del Informe para el pago	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Emisor del Informe para el pago	N	2
NombreEmisor	✓	Nombre del Emisor del Informe para el pago	A	5-450
valueInvoice	✓	Valor total de la factura electrónica a inscribir.	N	1-20
InvoiceID	✓	ID de la factura electrónica título valor	A	50
docType	✓	Tipo de la factura electrónica título valor	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica título valor	A	96
IDReceptor	✓	NIT del Receptor de la factura electrónica título valor	N	3-13
IDReceptorTipo	✓	Tipo de identificación del Receptor de la factura electrónica título valor	N	2
NombreReceptor	✓	Nombre del Receptor de la factura electrónica título valor	A	5-450
IssueDate	✓	Fecha de emisón de la factura electrónica título valor	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica título valor	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 046.

{
"status":"046",
"description":"Informe para pago",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"valueInvoice":"432000",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

047 Endoso con efectos de Cesión Ordinaria

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del Endoso	N	3	047
description	✓	Texto que describe el Endoso	A	0-500
operationType	✓	Código del Endoso	N	3	047
IDEmisor	✓	NIT del Emisor del Endoso	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Emisor del Endoso	N	2
NombreEmisor	✓	Nombre del Emisor del Endoso	A	5-450
IDEndosatario	✓	NIT del Receptor del Endoso	N	3-13
NombreEndosatario	✓	Nombre del Receptor del Endoso	A	5-450
TipoFactor	C	Se debe informar el elemento cuando el endoso es generado hacia un Factor 1 = Factoring 2 = Confirming	N	1
valuePaid	✓	Valor pagado por receptor de Endoso	N	1-20
valueInvoice	✓	Valor total de la factura electrónica a endosar	N	1-20
PrecioPagarseEndoso	✓	Precio a pagar de la factura electrónica a endosar	N	1-20
TasaDescuentoEndoso	✓	Tasa de descuento del endoso	N	0-7
MedioPago	✓	Medio de pago del endoso	N	1-3
Moneda	✓	Tipo moneda de la factura electrónica a endosar	N	3
InvoiceID	✓	ID de la factura electrónica a endosar	A	50
docType	✓	Tipo de la factura electrónica a endosar	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica a endosar	A	96
IDReceptor	✓	NIT del Receptor de la factura electrónica a endosar	N	3-13
IDReceptorTipo	✓	Tipo de identificación del Receptor de la factura electrónica a endosar	N	2
NombreReceptor	✓	Nombre del Receptor de la factura electrónica a endosar	A	5-450
IssueDate	✓	Fecha de emisón de la factura electrónica a endosar	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a endosar	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 047.

{
"status":"047",
"description":"Endoso con efectos de cesión ordinaria",
"operationType":"047",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoFactor":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

048 Protesto

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del Protesto	N	3	048
operationType	✓	Tipo del Protesto 481 = Protesto por falta de aceptación 482 = Protesto por falta de pago	N	3
IDEmisor	✓	NIT del Emisor del Protesto	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Emisor del Protesto	N	2
NombreEmisor	✓	Nombre del Emisor del Protesto	A	5-450
IDReceptor	✓	NIT del Receptor del Protesto	N	3-13
NombreReceptor	✓	Nombre del Receptor del Protesto	A	5-450
IDReceptorTipo	✓	Tipo de identificación del Receptor del Protesto	N	2
valueInvoice	C	Valor total de la factura electrónica título valor. Obligatorio para tipo protesto 482	N	1-20
ValorAceptado	C	Valor aceptado del derecho contenido en el título Obligatorio para tipo protesto 482	N	1-20
InvoiceID	✓	ID de la factura electrónica título valor	A	50
docType	✓	Tipo de la factura electrónica título valor	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica título valor	A	96
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica título valor	F	10
NumeroNotaria	✓	Debe ser informado el número de la Notaria
ActaProtesto	✓	Corresponde al Acta de Protesto el cual debe ser informado en Base64
NombreNotario	✓	Nombres del Notario	A	1-100
ApellidoNotario	✓	Apellidos del Notario	A	1-100
TituloNotario	✓	Cargo	A	1-100
FechaActaProtesto		Fecha en que se realizó el acta de Protesto	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 481 y Tipo = 481.

{
"status":"048",
"operationType":"481",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"valueInvoice":"432000",
"ValorAceptado":"14500",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"EndDateInvoice":"2023-01-30",
"NumeroNotaria":"5",
"ActaProtesto":"JVBERi0xLjcgCiXi48/TIAoxIDAgb2JqIAo8PCAKL1=",
"NombreNotario":"Notario 1",
"ApellidoNotario":"Notario 2",
"TituloNotario":"Notario principal",
"FechaActaProtesto":"2023-01-30",
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 481 y Tipo = 482.

{
"status":"048",
"operationType":"482",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"EndDateInvoice":"2023-01-30",
"NumeroNotaria":"5",
"ActaProtesto":"JVBERi0xLjcgCiXi48/TIAoxIDAgb2JqIAo8PCAKL1=",
"NombreNotario":"Notario 1",
"ApellidoNotario":"Notario 2",
"TituloNotario":"Notario principal",
"FechaActaProtesto":"2023-01-30",
}

049 Transferencia de los derechos económicos

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código de la Transferencia	N	3	049
description	✓	Texto que describe la Transferencia	A	0-500
operationType	✓	Código de la Transferencia 491 = Transferencia parcial de los derechos económicos con responsabilidad 492 = Transferencia total de los derechos económicos con responsabilidad 493 = Transferencia parcial de los derechos económicos sin responsabilidad 494 = Transferencia total de los derechos económicos sin responsabilidad	N	3
IDEmisor	✓	NIT del Emisor del Endoso	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Emisor del Endoso	N	2
NombreEmisor	✓	Nombre del Emisor del Endoso	A	5-450
IDEndosatario	✓	NIT del Receptor del Endoso	N	3-13
NombreEndosatario	✓	Nombre del Receptor del Endoso	A	5-450
ValorParcial	C	Este valor corresponde parcialmente al valor de la factura a transferir	N	1-20
valueInvoice	C	Este valor corresponde total al valor de la factura a transferir	N	1-20
PrecioPagarseEndoso	✓	Precio a pagar de la factura electrónica a transferir	N	1-20
TasaDescuentoEndoso	✓	Tasa de descuento de la transferencia	N	0-7
MedioPago	✓	Medio de pago de la transferencia	N	1-3
Moneda	✓	Tipo moneda de la factura electrónica a transferir	N	3
InvoiceID	✓	ID de la factura electrónica a transferir	A	50
docType	✓	Tipo de la factura electrónica a transferir	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica a transferir	A	96
IDReceptor	✓	NIT del Receptor de la factura electrónica a transferir	N	3-13
IDReceptorTipo	✓	Tipo de identificación del Receptor de la factura electrónica a transferir	N	2
NombreReceptor	✓	Nombre del Receptor de la factura electrónica a transferir	A	5-450
IssueDate	✓	Fecha de emisón de la factura electrónica a transferir	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a transferir	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia unevento 049 tipo 491.

{
"status":"049",
"description":"Transferencia de los derechos económicos",
"operationType":"491",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"ValorParcial":"100000",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

050 Notificación de la transferencia de derechos económicos

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del evento	N	3	050
description	✓	Texto que describe el evento	A	0-500
IDEmisor	✓	NIT del Emisor del Informe para el pago	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Emisor del Informe para el pago	N	2
NombreEmisor	✓	Nombre del Emisor del Informe para el pago	A	5-450
ValorActual	✓	Valor actual del título valor	N	1-20
InvoiceID	✓	ID de la factura electrónica título valor	A	50
docType	✓	Tipo de la factura electrónica título valor	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica título valor	A	96
IDReceptor	✓	NIT del Receptor de la factura electrónica título valor	N	3-13
IDReceptorTipo	✓	Tipo de identificación del Receptor de la factura electrónica título valor	N	2
NombreReceptor	✓	Nombre del Receptor de la factura electrónica título valor	A	5-450
IssueDate	✓	Fecha de emisón de la factura electrónica título valor	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica título valor	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 050.

{
"status":"050",
"description":"Notificación al deudor sobre la transferencia de los derechos económicos",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"ValorActual":"432000",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

051 Pago de la transferencia de derechos económicos

Estructura Json

A Alfanumérico: son aceptados los caracteres UNICODE permitidos en el XML; corresponde al tipo xsd:normalizedString
N Numérico: solamente son aceptados los números “0” a “9”, el punto de separación decimal, y las señales “+” y “-“
F Fecha: elementos que deben ser informados en el formato YYYY-MM-DD, de acuerdo con la norma ISO 8601-2, en el cual:

• YYYY: año
• MM: mes
• DD: día

✓ = dato obligatorio
C = dato condicional

Parámetro	Obligatorio	Descripción	Tipo de dato	Tamaño	Valor
status	✓	Código del evento	N	3	051
operationType	✓	Tipo de Pago 511 = Pago parcial de la transferencia de los derechos económicos 512 = Pago total de la transferencia de los derechos económicos	N	3
IDEmisor	✓	NIT del Emisor del Pago	N	3-13
IDEmisorTipo	✓	Tipo de identificación del Pago	N	2
NombreEmisor	✓	Nombre del Emisor del Pago	A	5-450
TipoPago	✓	Tipo de identificación del Pago 1 = Sin limitación - Pago de la factura sin limitación 2 = Con limitación - Pago de la factura con limitación	N	1
ValorActualTituloValor	✓	Valor actual del titulo valor	N	1-20
ValorPendienteTituloValor	✓	Saldo insoluto del valor total a la fecha de este pago	N	1-20
ValorPagado	✓	Valor Pagado sobre el valor total de la FEV o Titulo Valor	N	1-20
InvoiceID	✓	ID de la factura electrónica título valor	A	50
docType	✓	Tipo de la factura electrónica título valor	N	2	01
CUFEInvoice	✓	CUFE de la factura electrónica título valor	A	96
FechaPago	✓	Fecha de pago de la factura electrónica título valor	F	10
EndDateInvoice	✓	Fecha de vencimiento de la factura electrónica a inscribir	F	10

Ejemplo Json

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 051 Pago parcial tipo 511.

{
"status":"051",
"operationType":"511",
"description":"Pago de factura",
"IDEmisor":"890900608",
"IDEmisorTipo":"31",
"NombreEmisor":"ALMACENES EXITO S A",
"TipoPago":"1",
"ValorActualTituloValor":"400000",
"ValorPendienteTituloValor":"32000",
"ValorPagado":"432000",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"FechaPago":"2023-01-03",
"EndDateInvoice":"2022-12-30"
}

En el siguiente ejemplo mostramos cómo realizar una petición Json donde se envia un evento 051 Pago total tipo 512.

{
"status":"051",
"operationType":"512",
"description":"Pago de factura",
"IDEmisor":"890900608",
"IDEmisorTipo":"31",
"NombreEmisor":"ALMACENES EXITO S A",
"TipoPago":"1",
"ValorActualTituloValor":"432000",
"ValorPendienteTituloValor":"0",
"ValorPagado":"432000",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"FechaPago":"2023-01-03",
"EndDateInvoice":"2022-12-30"
}