Diferencia entre revisiones de «Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa»
(→Class.FacturaGeneral) |
(→Class.FacturaGeneral) |
||
(No se muestran 20 ediciones intermedias de 5 usuarios) | |||
Línea 1: | Línea 1: | ||
− | <includeonly>=</includeonly>==Método Servicio Emisión Web Soap==<includeonly>=</includeonly> | + | <includeonly>=</includeonly>==<font color="blue">Método Servicio Emisión Web Soap</font>==<includeonly>=</includeonly> |
Los parámetros a incorporar en los métodos de este Web Service deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas: | Los parámetros a incorporar en los métodos de este Web Service deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas: | ||
Línea 44: | Línea 44: | ||
{{clear}} | {{clear}} | ||
− | ===Método Enviar=== | + | ===<font color="blue">Método Enviar</font>=== |
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico. | La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico. | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 70: | Línea 70: | ||
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA | : “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA | ||
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA | : “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA | ||
− | : “10” No se admiten adjuntos. Se genera | + | : “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA |
− | : “11” Admite archivos adjuntos. Se genera | + | : “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA |
|} | |} | ||
Línea 114: | Línea 114: | ||
</center> | </center> | ||
{{clear}} | {{clear}} | ||
− | ====Class.FacturaGeneral==== | + | |
+ | ====<font color="blue">Class.FacturaGeneral</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 164: | Línea 165: | ||
| | | | ||
: Información del adquiriente | : Información del adquiriente | ||
+ | : Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado | ||
: '''PATH''':/root/cac:AccountingCustomerParty | : '''PATH''':/root/cac:AccountingCustomerParty | ||
: (ver detalle en [[#Class.Cliente|Class.Cliente]]) | : (ver detalle en [[#Class.Cliente|Class.Cliente]]) | ||
Línea 178: | Línea 180: | ||
|consecutivoDocumento | |consecutivoDocumento | ||
|String | |String | ||
− | | AN.. | + | | AN..14 |
|SI | |SI | ||
| | | | ||
Línea 340: | Línea 342: | ||
: Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial. | : Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial. | ||
: Ejemplo: ‘PREF-1123456’ | : Ejemplo: ‘PREF-1123456’ | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el valor del campo desde (Inicio del rango) supera el valor '''2.147.483.647'''. | ||
: '''PATH''': | : '''PATH''': | ||
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/ | : /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/ | ||
Línea 497: | Línea 500: | ||
|} | |} | ||
− | ====Class.Anticipos==== | + | ====<font color="blue">Class.Anticipos</font>==== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 564: | Línea 567: | ||
: '''PATH''': …/cbc:PaidAmount | : '''PATH''': …/cbc:PaidAmount | ||
|} | |} | ||
− | ====Class.Autorizado==== | + | |
+ | ====<font color="blue">Class.Autorizado</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 672: | Línea 676: | ||
|} | |} | ||
− | ====Class.CargosDescuentos==== | + | ====<font color="blue">Class.CargosDescuentos</font>==== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 756: | Línea 760: | ||
: '''PATH''': …/cbc:ID | : '''PATH''': …/cbc:ID | ||
|} | |} | ||
− | ====Class.Cliente==== | + | |
+ | ====<font color="blue">Class.Cliente</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 967: | Línea 972: | ||
: '''PATH''': …/cbc:AdditionalAccountID | : '''PATH''': …/cbc:AdditionalAccountID | ||
|} | |} | ||
− | ====Class.CondicionPago==== | + | |
+ | ====<font color="blue">Class.CondicionPago</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 1107: | Línea 1113: | ||
: '''PATH''': ../cac:PrepaidPaymentReferenceID | : '''PATH''': ../cac:PrepaidPaymentReferenceID | ||
|} | |} | ||
− | ====Class. | + | |
+ | ====<font color="blue">Class.Coordenadas</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 1115: | Línea 1122: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |gradosLatitud |
− | |String | + | |String |
− | | | + | |Por Definir |
− | | NO | + | |NO |
| | | | ||
− | : | + | : Medida de la latitud en grados |
− | + | : '''PATH''': ../cbc:LatitudeDegreesMeasure | |
− | : '''PATH''': .. | ||
|- | |- | ||
− | | | + | |gradosLongitud |
|String | |String | ||
− | | | + | |Por Definir |
− | | | + | |NO |
| | | | ||
− | : | + | : Medida de la longitud en grados |
− | : '''PATH''': .. | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Unidad superior a 60 minutos |
+ | : '''PATH''': ../cbc:LongitudeDegreesMeasure | ||
|- | |- | ||
− | | | + | |minutosLatitud |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|…5|2.2</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Medida de la latitud en minutos decimales en formato mm.mm |
− | + | : '''PATH''': ../cbc:MarkAttentionIndicator | |
− | |||
− | : '''PATH''': .. | ||
|- | |- | ||
− | | | + | |minutosLongitud |
|String | |String | ||
− | |<nowiki>N|. | + | |<nowiki>N|…5|2.2</nowiki> |
− | | | + | |NO |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| | | | ||
− | : | + | : Medida de la longitud en minutos decimales en formato mm.mm |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Unidad superior a 60 minutos | |
− | : | + | : '''PATH''': ../cbc:LongitudeMinutesMeasure |
− | : '''PATH''': ../ | ||
− | : | ||
|- | |- | ||
− | | | + | |orientacionLatitud |
|String | |String | ||
− | | | + | |<nowiki>AN|1</nowiki> |
− | |NO | + | |NO |
| | | | ||
− | : | + | : Sentido de medida de la latitud con relación al Ecuador |
− | : '''PATH''': .. | + | : '''PATH''': ../cbc:LatitudeDirectionCode |
− | |||
|- | |- | ||
− | | | + | |orientacionLongitud |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|1</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Sentido de medida de la longitud con relación al Ecuador |
− | : < | + | : '''PATH''': ../cbc:LongitudeDirectionCode |
− | : | + | |} |
− | |- | + | |
− | | | + | ====<font color="blue">Class.DatosTransportistas</font>==== |
− | | | + | {| class="mw-collapsible mw-collapsed wikitable" |
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Atributo |
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato |
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |detallesTributarios | ||
+ | |Tributos | ||
+ | | - | ||
+ | |NO | ||
| | | | ||
− | : | + | : Tipos de Impuesto |
− | : '''PATH''': .. /cac: | + | : '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme |
+ | : (ver detalle en [[#Class.Tributos|Class.Tributos]]) | ||
|- | |- | ||
− | | | + | |direccionResponsableEntrega |
− | | | + | |Direccion |
− | | | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | : Información de la Dirección del Responsable de Entrega |
− | + | : '''PATH''': ../cac:Address/cbc:PhysicalLocation | |
− | + | : (ver detalle en [[#Class.Direccion|Class.Direccion]]) | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |email |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
− | | | + | | |
− | : | + | : Correo Electrónico |
− | : '''PATH''': .. | + | : '''PATH''': ..cac:Contact/cbc:ElectronicMail |
+ | |- | ||
+ | |extras | ||
+ | |Array <Extensible> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | : Campos o información opcional para el modelo de negocio del emisor. | ||
+ | : '''PATH''': No definido | ||
+ | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |indicadordeAtencion |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Indicador si es información sobre “para la atención de” (FAO) |
− | : '''PATH''': .. | + | : '''PATH''': ../cbc:MarkAttentionIndicator |
|- | |- | ||
− | | | + | |indicadordeCuidado |
− | | | + | |String |
− | | | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Indicador si es información sobre alguien responsable por los bienes |
− | + | : '''PATH''': ../cbc:MarkCareIndicator | |
− | : '''PATH''': / | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |nombreContacto |
|String | |String | ||
− | |AN | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Nombre de Contacto |
− | + | : '''PATH''': .. /cac:Contact/cbc:Name | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | : '''PATH''': /cac: | ||
|- | |- | ||
− | | | + | |nombreResponsableEntrega |
|String | |String | ||
− | |AN | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Nombre del Responsable de la Entrega |
− | + | : '''PATH''': ../cac:PartyName/cbc:Name | |
− | |||
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |nota |
|String | |String | ||
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Nota de Contacto |
− | + | : '''PATH''': ../cac:Contact/cbc:Note | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |numeroIdentificacion |
|String | |String | ||
− | |AN | + | |<nowiki>AN|…12</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : NIT del transportista |
− | + | : '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |numeroIdentificacionDV |
|String | |String | ||
− | | | + | |<nowiki>N|..2</nowiki> |
|NO | |NO | ||
− | | | + | | |
− | : | + | : Digito Verificador |
− | + | : '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |numeroMatriculaMercantil |
|String | |String | ||
− | | | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Número de matrícula mercantil |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name |
|- | |- | ||
− | | | + | |prefijoFacturacion |
|String | |String | ||
− | | | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Prefijo de facturación del Transportista |
− | : '''PATH''': ../cac: | + | : '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID |
|- | |- | ||
− | | | + | |responsabilidadesRut |
− | |Array | + | |Array <Obligaciones> |
| - | | - | ||
|NO | |NO | ||
| | | | ||
− | : | + | : Responsabilidad del Transportista |
− | : '''PATH''': | + | : '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode |
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]]) |
|- | |- | ||
− | | | + | |telefax |
− | | | + | |String |
− | | | + | |<nowiki>AN|..20</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Telefax de transportista |
− | : | + | : '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName |
− | + | |- | |
− | + | |telefono | |
− | : | + | |String |
− | : '''PATH''': ../cac: | + | |<nowiki>AN|..20</nowiki> |
− | + | |NO | |
− | : | + | | |
+ | : Teléfono de transportista | ||
+ | : '''PATH''': ../cac:Contact/cbc:Telefax | ||
|- | |- | ||
− | | | + | |tipoIdentificacion |
− | | | + | |String |
− | | | + | |<nowiki>N|2</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Tipo de Identificación del Transportista |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este atributo no corresponde a uno de los valores de la en [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]] | |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el | + | : '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName |
− | |||
− | : '''PATH''': ../cac: | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |transportadorDireccion |
− | | | + | |Direccion |
| - | | - | ||
|NO | |NO | ||
| | | | ||
− | : | + | : Dirección fiscal del transportador |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress |
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Direccion|Class.Direccion]]) |
|- | |- | ||
− | | | + | |transportadorNombre |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Nombre del transportador |
− | + | : '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |transportadorNumeroDocumento |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|..12</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Numero documento del transportador |
− | + | : '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |transportadorNumeroDocumentoDV |
− | |String | + | |String |
− | |<nowiki> | + | |<nowiki>AN|..2</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Digito Verificador del NIT del transportador |
− | + | : '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID | |
− | |||
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |transportadorTipoIdentificacion |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|2</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Tipo documento del transportador |
− | : ''' | + | : '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName |
− | + | |} | |
− | : | + | |
+ | ====<font color="blue">Class.Destinatario</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |canalDeEntrega |
|String | |String | ||
− | | | + | | - |
− | | | + | |SI |
| | | | ||
− | : | + | : Medio de Entrega del Documento Electrónico |
− | : | + | : Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram |
− | : | + | : PATH: No aplica |
− | : | ||
|- | |- | ||
− | | | + | |email |
− | |String | + | |Array <String> |
− | | | + | | - |
− | |C/C | + | |C/C |
| | | | ||
− | : | + | : Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico si el canalDeEntrega=’0’ |
− | : '''Obligatorio''' | + | : '''Obligatorio''' Cuando canalDeEntrega=’0’ |
− | + | : '''PATH''': No aplica | |
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |extras |
− | + | |Array <Extensible> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor |
− | : '''PATH''': .. | + | : '''PATH''': No definido |
+ | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |fechaProgramada |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|19</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Fecha programada |
− | + | : '''PATH''': No aplica | |
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |mensajeProgramado |
|String | |String | ||
− | | | + | | - |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Mensaje |
− | + | : '''PATH''': No aplica | |
− | |||
− | |||
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |nitProveedorReceptor |
|String | |String | ||
− | | | + | |<nowiki>N|..12</nowiki> |
− | |||
|C/C | |C/C | ||
| | | | ||
− | : | + | : NIT del Destinatario |
− | + | : '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’ | |
− | : '''Obligatorio''' | + | : '''PATH''': No aplica |
− | : '''PATH''': No | ||
|- | |- | ||
− | | | + | |telefono |
|String | |String | ||
− | | | + | |<nowiki>AN|..20</nowiki> |
− | + | |C/C | |
− | |||
| | | | ||
− | : | + | : Teléfono del Destinatario |
− | : | + | : '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’ |
− | : | + | : '''PATH''': No aplica |
− | : | + | |} |
+ | |||
+ | |||
+ | |||
+ | ====<font color="blue">Class.DetalleDeFactura</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |cantidadPorEmpaque |
− | |String | + | |String |
− | | | + | | <nowiki>N|..3 </nowiki> |
− | + | | NO | |
− | | | ||
| | | | ||
− | : | + | : Cantidad de unidad de este artículo por empaque. |
− | : '''PATH''': .. | + | : Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18 |
+ | : '''PATH''': ..cac:Item/cbc:PackSizeNumeric | ||
|- | |- | ||
− | | | + | |cantidadReal |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..6</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : Cantidad real sobre la cual el precio aplica |
− | + | : '''PATH''': .. /cac:Price/cbc:BaseQuantity | |
− | |||
− | : '''PATH''': ../cbc: | ||
|- | |- | ||
− | | | + | |cantidadRealUnidadMedida |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..6</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Unidad de la cantidad sobre la cual el precio aplica |
− | : '''PATH''': ../cac: | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]] |
+ | : (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos) | ||
+ | : '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode | ||
|- | |- | ||
− | | | + | |cantidadUnidades |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..6</nowiki> |
− | | | + | |SI |
+ | | | ||
+ | : Cantidad de unidades del producto/servicio facturado | ||
+ | : '''PATH''': .. /cbc:InvoicedQuantity | ||
+ | |- | ||
+ | |cargosDescuentos | ||
+ | |Array <CargosDescuentos> | ||
+ | | - | ||
+ | |C/C | ||
| | | | ||
− | : | + | : Información de cargos y descuentos |
− | : '''PATH''': ../cac: | + | : '''Obligatorio''' Este arreglo se debe informar a nivel de ítem, si y solamente si el cargo o descuento afecta la base gravable del ítem. |
+ | : Si un cargo individual general a la factura genera IVA, debe reportarse como ítem | ||
+ | : '''PATH''': ../cac:AllowanceCharge | ||
+ | : (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]]) | ||
|- | |- | ||
− | | | + | |codigoFabricante |
|String | |String | ||
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : Código del | + | : Código del fabricante correspondiente al artículo |
− | : '''PATH''': ../Item/cac: | + | : '''PATH''': .. /cac:Item/cac: |
+ | : ManufacturersItemIdentification/cbc:ID | ||
|- | |- | ||
− | | | + | |codigoIdentificadorPais |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>A|2</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Código Identificador del país de origen del artículo o servicio |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2 |
+ | : '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode | ||
|- | |- | ||
− | | | + | |codigoProducto |
− | |String | + | |String |
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
|SI | |SI | ||
| | | | ||
− | : Código | + | : Código del vendedor correspondiente al artículo |
− | + | : '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID | |
− | |||
− | : '''PATH''': ../ | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |codigoTipoPrecio |
|String | |String | ||
− | | | + | |<nowiki>AN|..3</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Código del tipo de precio informado |
− | : | + | : '''Obligatorio''' Para muestras comerciales (valor = 01) |
− | : PATH: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]] |
+ | : '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode | ||
|- | |- | ||
− | | | + | |descripcion |
− | | | + | |String |
− | | | + | |<nowiki>AN|..300</nowiki> |
|C/C | |C/C | ||
− | | | + | | |
− | : | + | : Descripción del producto o servicio |
− | : ''' | + | : '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.''' |
− | : '''PATH''': | + | : '''PATH''': ../Item/cbc:Description[1] |
|- | |- | ||
− | | | + | |descripcion2 |
− | | | + | |String |
− | | | + | |<nowiki>AN|..300</nowiki> |
− | | | + | |C/C |
− | | | + | | |
− | : | + | : Descripción del producto o servicio |
− | : '''PATH''': | + | : '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.''' |
− | : | + | : '''PATH''': ../Item/cbc:Description[2] |
|- | |- | ||
− | | | + | |descripcion3 |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|..300</nowiki> |
− | | | + | |C/C |
− | | | + | | |
− | : | + | : '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.''' |
− | : '''PATH''': | + | : '''PATH''': ../Item/cbc:Description[3] |
|- | |- | ||
− | | | + | |descripcionTecnica |
|String | |String | ||
− | | | + | |<nowiki>AN|..300</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Datos técnicos asociados al producto o servicio |
− | : '''PATH''': | + | : '''PATH''': .. /cac:Item/cbc:AdditionalInformation |
+ | |- | ||
+ | |documentosReferenciados | ||
+ | |Array <DocumentoReferenciado> | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | : Informaciones que describen un documento referenciado | ||
+ | : '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse) | ||
+ | : '''PATH''': /root/cac:DiscrepancyResponse, | ||
+ | : /root/cac:BillingReference, | ||
+ | : /root/cac: AdditionalDocumentReference, | ||
+ | : /root/cac: DespatchDocumentReference, | ||
+ | : /root/cac: ReceiptDocumentReference | ||
+ | : (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]) | ||
|- | |- | ||
− | | | + | |estandarCodigo |
|String | |String | ||
− | | | + | |AN |
|C/C | |C/C | ||
| | | | ||
− | : | + | : Código del estándar (identificación del artículo o servicio de acuerdo con un estándar) |
− | : '''Obligatorio''' | + | : Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]] |
− | : '''PATH''': | + | : '''Obligatorio''' Para documento soporte y nota de ajuste. |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el código no existe en un estándar cerrado. | ||
+ | : Ejemplo: UNSPSC | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el código no sigue la regla de formación de un código abierto, pero con valores verificables | ||
+ | : Ejemplo: GTIN, Ejemplo:Partidas arancelarias | ||
+ | : '''Nota''': En este caso puede utilizarse el código 999 (Estándar de adopción del contribuyente) para evitar reclasificar los productos | ||
+ | : '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID | ||
|- | |- | ||
− | | | + | |estandarCodigoID |
|String | |String | ||
− | | | + | |AN |
− | | | + | |NO |
| | | | ||
− | : | + | : Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar). |
− | : | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si estandarCodigo = 010 y estandarCodigoID es diferente a 9 |
− | + | : Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]] | |
− | + | : '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |estandarCodigoIdentificador |
|String | |String | ||
− | | | + | |AN |
− | | | + | |NO |
| | | | ||
− | : | + | : Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar). |
− | : | + | : Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]] |
− | + | : '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |estandarCodigoNombre |
|String | |String | ||
− | | | + | |AN |
− | | | + | |NO |
| | | | ||
− | : | + | : Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar). |
− | + | : Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]] | |
− | # | + | : '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName |
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |estandarCodigoProducto |
|String | |String | ||
− | | | + | |AN |
− | | | + | |C/C |
+ | | | ||
+ | : Código del producto según el estándar informado en estandarCodigo | ||
+ | : '''Obligatorio''' Para documento soporte y nota de ajuste. | ||
+ | : Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]] | ||
+ | : '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID | ||
+ | |- | ||
+ | |estandarOrganizacion | ||
+ | |String | ||
+ | | - | ||
+ | |NO | ||
| | | | ||
− | : | + | : Estándar de la organización |
− | + | : '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name | |
− | |||
− | : ''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |estandarSubCodigoProducto |
− | | | + | |String |
− | | | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | : Sub código del estándar del producto |
− | + | : '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
|extras | |extras | ||
− | |Array <Extensible> | + | |Array <Extensible> |
| - | | - | ||
|NO | |NO | ||
Línea 1642: | Línea 1653: | ||
: (ver detalle en [[#Class.Extensible|Class.Extensible]]) | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |impuestosDetalles |
− | + | |Array <FacturaImpuestos > | |
− | |< | + | | - |
− | | | + | |SI |
| | | | ||
− | : | + | : Información de impuestos |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si existe más de un elemento con el mismo valor en el atributo FacturaImpuestos.codigoTOTALImp | |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si | + | : Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario. |
− | : '''PATH''': | + | : Adicionalmente, NO debe ser informado para facturas del régimen simple grupo I, ni para ítems cuyo concepto en contratos de AIU no haga parte de la base gravable. |
− | : | + | : A nivel de ítem solo aplica para tributos que deban informarse a nivel de ítem, por ejemplo: IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros |
− | : | + | : '''PATH''': ../cac:TaxTotal (impuestos), |
− | + | : ../cac: WithholdingTaxTotal (retenciones) | |
+ | : (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]]) | ||
|- | |- | ||
− | | | + | |impuestosTotales |
− | + | |Array <ImpuestosTotales> | |
− | |< | + | | - |
− | | | + | |SI |
| | | | ||
− | : | + | : Sumatoria de los impuestos por todos los tipos |
− | : '''PATH''': | + | : Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario. |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el valor del valor total del impuesto indicado es diferente a la sumatoria de lo reportado en FacturaImpuestos. valorTOTALImp. | ||
+ | : A nivel de ítem solo aplica para tributos que deban informase a nivel de ítem, por ejemplo, IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros | ||
+ | : '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos), | ||
+ | : ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones) | ||
+ | : (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]]) | ||
|- | |- | ||
− | | | + | |informacionAdicional |
− | + | |Array <LineaInformacionAdicional> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Sirve para adicionar información específica del producto que puede ser solicitada por autoridades o entidades diferentes a la DIAN |
− | : '''PATH''': | + | : '''PATH''': ../cac:Item/cac:AdditionalItemProperty |
+ | : (ver detalle en [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]) | ||
|- | |- | ||
− | | | + | |mandatorioNumeroIdentificacion |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..12</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : NIT del mandatario |
− | : | + | : '''Obligatorio''' para facturas por mandato |
− | : '''PATH''': | + | : '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID |
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |mandatorioNumeroIdentificacionDV |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..2</nowiki> |
+ | |C/C | ||
+ | | | ||
+ | : Digito Verificador del NIT del mandatario | ||
+ | : '''Obligatorio''' para facturas por mandato | ||
+ | : '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID | ||
+ | |- | ||
+ | |mandatorioTipoIdentificacion | ||
+ | |String | ||
+ | |<nowiki>N|2</nowiki> | ||
|C/C | |C/C | ||
| | | | ||
− | : | + | : Tipo de identificación del mandatario |
− | + | : '''Obligatorio''' Para facturas por mandato | |
− | : '''Obligatorio''' | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si mandatorioNumeroIdentificacion es informado y el valor del este campo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]] |
− | : '''PATH''': | + | : '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName |
− | |||
− | |||
|- | |- | ||
− | | | + | |marca |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..100</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Marca del artículo. |
− | : | + | : '''Obligatorio''' Si es factura internacional |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si tipoDocumento = “02” y este elemento no fue informado |
+ | : '''PATH''': ../Item/cbc:BrandName | ||
|- | |- | ||
− | | | + | |modelo |
− | |String | + | |String |
− | |<nowiki>AN| | + | |<nowiki>AN|..100</nowiki> |
− | |C/C | + | |C/C |
| | | | ||
− | : | + | : Modelo del artículo. |
− | : '''Obligatorio''' | + | : '''Obligatorio''' Si es factura internacional |
− | : <span style="color:#FFFF; background:#FF0000"><b> | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si tipoDocumento = “02” y este elemento no fue informado |
− | + | : '''PATH''': ../Item/cbc:ModelName | |
− | : '''PATH''': / | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |muestraGratis |
− | | | + | |String |
− | | | + | |<nowiki>N|1</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Indicador de si el ítem es gratuito o no (sin valor comercial) |
− | : '''PATH''': ../ | + | : '''Obligatorio''' Para muestras comerciales |
− | + | : Valores posibles: “1” (Es muestra gratis) ó “0” (No es muestra gratis) | |
+ | : '''PATH''': ../cbc:FreeOfChargeIndicator | ||
|- | |- | ||
− | | | + | |nombreFabricante |
− | | | + | |String |
− | | | + | |<nowiki>AN|..100</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Nombre del fabricante del producto/servicio |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name |
− | : | ||
|- | |- | ||
− | | | + | |nota |
− | | | + | |String |
− | | | + | |<nowiki>AN|20..5000</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Texto libre para añadir información adicional al artículo |
− | : '''PATH''': ../ | + | : '''Obligatorio''' Informar para el caso de facturas por contratos de servicio tipo AIU. Para el ítem Adminsitración. En este caso la nota debe empezar por el texto: “Contrato de servicios AIU por concepto de:” El contribuyente debe incluir el objeto del contrato facturado |
− | + | : '''PATH''': ../cbc:Note | |
|- | |- | ||
− | | | + | |precioReferencia |
− | | | + | |String |
− | | | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |C/C | ||
| | | | ||
− | : | + | : Valor del artículo o servicio. |
− | : '''PATH''': | + | : Corresponde al valor del precio referencia del ítem que se da como muestra o regalo sin valor comercial |
− | + | : '''Obligatorio''' Para muestras comerciales | |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial | ||
+ | : '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount | ||
|- | |- | ||
− | | | + | |precioTotal |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |C/C | ||
| | | | ||
− | : | + | : Precio total del producto o servicio. |
− | : | + | : (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos) |
− | : '''PATH''': | + | : '''Obligatorio''' Para uso en las representaciones gráficas |
+ | : '''PATH''': No definido | ||
|- | |- | ||
− | | | + | |precioTotalSinImpuestos |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Valor total de la línea sin impuestos. |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> | + | : (cantidadUnidades*precioVentaUnitario +cargos-descuentos) |
− | : '''PATH''': .. | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si se informa el atributo precioTotalSinImpuestos en 0.00 entonces el valor de precioReferencia debe ser informado ya que se trata de muestra o regalo comercial |
+ | : '''PATH''': ../cbc:LineExtensionAmount | ||
|- | |- | ||
− | | | + | |precioVentaUnitario |
|String | |String | ||
− | |<nowiki>AN| | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
+ | | | ||
+ | : Precio Unitario del porducto/servicio | ||
+ | : '''PATH''': ../Price/cbc:PriceAmount | ||
+ | |- | ||
+ | |secuencia | ||
+ | |String | ||
+ | |<nowiki>AN|..4</nowiki> | ||
+ | |SI | ||
| | | | ||
− | : | + | : Indicador de orden de secuencia (número de línea) |
− | : <span style="color:#FFFF; background:#FF0000"><b> | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo |
− | : '''PATH''': .. | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si los números utilizados en los diferentes grupos no son consecutivos, empezando en “1” |
+ | : '''PATH''': ../cbc:ID | ||
|- | |- | ||
− | | | + | |seriales |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|..500</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Seriales del producto (separador por coma), Ej: ABC123,ABC456 |
− | + | : '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |subCodigoFabricante |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Código del fabricante correspondiente a una sub-especificación del artículo |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID |
|- | |- | ||
− | | | + | |subCodigoProducto |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Código del emisor/vendedor correspondiente a una sub-especificación del artículo |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID |
+ | |- | ||
+ | |tipoAIU | ||
+ | |String | ||
+ | |<nowiki>AN|..50</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | : Para Clasificar el tipo de AIU | ||
+ | : '''PATH''': No aplica | ||
+ | |- | ||
+ | |unidadMedida | ||
+ | |String | ||
+ | |<nowiki>AN|..3</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Código de Unidad de medida del producto/servicio facturado | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el valor del atributo no se encuentra en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]] | ||
+ | : (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos) | ||
+ | : '''PATH''': ../cbc:InvoicedQuantity@unitCode | ||
|} | |} | ||
− | ====Class. | + | |
+ | ====<font color="blue">Class.Direccion</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 1829: | Línea 1868: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |aCuidadoDe |
− | |String | + | |String |
− | |<nowiki>AN| | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Cuidado de |
− | : '''PATH''': | + | : '''PATH''': ../cac:Address/cbc:MarkCare |
|- | |- | ||
− | | | + | |aLaAtenciónDe |
|String | |String | ||
− | | | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : A la atención de |
− | : '''PATH''': | + | : '''PATH''': ../cac:Address/cbc:MarkAttention |
|- | |- | ||
− | | | + | |bloque |
|String | |String | ||
− | | | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Nombre del bloque |
− | + | : '''PATH''': ../cac:Address/cbc:BlockName | |
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |buzon |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Buzón postal |
− | + | : '''PATH''': ../cac:Address/cbc:Postbox | |
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |calle |
|String | |String | ||
− | | | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Nombre de la calle |
− | : '''PATH''': | + | : '''PATH''': ../cac:Address/cbc:StreetName |
|- | |- | ||
− | | | + | |calleAdicional |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Nombre Adicional para especificar mejor el nombre de la calle |
− | + | : '''PATH''': ../cac:Address/cbc:AdditionalStreetName | |
− | : '''PATH''': | + | |- |
− | | | + | |ciudad |
− | + | |String | |
− | + | |<nowiki>AN|…50</nowiki> | |
− | + | |SI | |
− | + | | | |
− | + | : Ciudad | |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico) | |
− | + | : '''PATH''': ../cac:Address/cbc:CityName | |
|- | |- | ||
− | | | + | |codigoDepartamento |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|…5</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Código del departamento |
− | : '''PATH''': | + | : Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]] |
+ | : '''Obligatorio''' para Emisores y Adquirentes Responsables | ||
+ | : '''PATH''': ../cac:Address/cbc:CountrySubentityCode | ||
|- | |- | ||
− | | | + | |correccionHusoHorario |
|String | |String | ||
− | | | + | |<nowiki>AN|6</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Corrección del uso horario correspondiente |
− | : '''PATH''': | + | : '''PATH''': ../cac:Address/cbc:TimezoneOffset |
|- | |- | ||
− | | | + | |departamento |
|String | |String | ||
− | | | + | |<nowiki>AN|…50</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : Nombre del departamento |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]] |
+ | : '''PATH''': ../cac:Address/cbc:CountrySubentity | ||
|- | |- | ||
− | | | + | |departamentoOrg |
|String | |String | ||
− | | | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Un departamento direccionable de una organización |
− | : '''PATH''': | + | : '''PATH''': ../cac:Address/cbc:Department |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |direccion |
|String | |String | ||
− | | | + | |<nowiki>AN|…100</nowiki> |
− | |||
|SI | |SI | ||
| | | | ||
− | : | + | : Dirección del cliente, sin indicar ciudad ni departamento |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line |
|- | |- | ||
− | | | + | |distrito |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Distrito |
− | + | : '''PATH''': /cac:Address/cbc:District | |
− | : '''PATH''': | ||
|- | |- | ||
− | + | |extras | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |extras | ||
|Array <Extensible> | |Array <Extensible> | ||
| - | | - | ||
|NO | |NO | ||
| | | | ||
− | : Campos o información opcional para el modelo de negocio del emisor | + | : Campos o información opcional para el modelo de negocio del emisor. |
: '''PATH''': No definido | : '''PATH''': No definido | ||
: (ver detalle en [[#Class.Extensible|Class.Extensible]]) | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |habitacion |
|String | |String | ||
− | | | + | |<nowiki>AN|..50</nowiki> |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Habitación |
− | + | : '''PATH''': ../cac:Address/cbc:Room | |
− | |||
− | : '''PATH''':../cac: | ||
|- | |- | ||
− | | | + | |lenguaje |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>A|2</nowiki> ISO 639-1 |
− | |SI | + | |SI |
| | | | ||
− | : | + | : Identificador del lenguaje utilizado en el nombre del país |
− | : <span style="color:#FFFF; background:#FF0000"><b> | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1 |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es” |
+ | : '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID | ||
|- | |- | ||
− | | | + | |localizacion |
− | | | + | |Array <Coordenadas> |
− | | | + | |<nowiki>AN|..50</nowiki> |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Coordenadas de la dirección |
− | + | : '''PATH''': ../cac:Address/cac:LocationCoordinate | |
− | + | : (ver detalle en [[#Class.Coordenadas|Class.Coordenadas]]) | |
− | : '''PATH''': ../cac: | ||
|- | |- | ||
− | | | + | |municipio |
|String | |String | ||
− | | | + | |<nowiki>AN|..50</nowiki> |
− | |||
|SI | |SI | ||
| | | | ||
− | : | + | : Código del Municipio |
− | : <span style="color:#FFFF; background:#FF0000"><b> | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] |
− | + | : '''PATH''': ../cbc:ID | |
− | : '''PATH''': .. | ||
|- | |- | ||
− | | | + | |nombreEdificio |
− | |String | + | |String |
− | | | + | |<nowiki>AN|..50</nowiki> |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Nombre de un Edificio |
− | : ''' | + | : '''PATH''': ../cac:Address/cbc:BuildingName |
− | : | + | |- |
− | : '''PATH''': ../cac: | + | |numeroEdificio |
− | | | + | |String |
− | + | |<nowiki>AN|..50</nowiki> | |
− | + | |NO | |
− | + | | | |
− | + | : Número de una casa o edificio | |
− | + | : '''PATH''': ../cac:Address/cbc:BuildingNumber | |
− | + | |- | |
− | + | |numeroParcela | |
− | + | |String | |
+ | |<nowiki>AN|..50</nowiki> | ||
+ | |NO | ||
+ | | | ||
+ | : Número de Parcela | ||
+ | : '''PATH''': ../cac:Address/cbc:PlotIdentification | ||
|- | |- | ||
− | | | + | |pais |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>A|2</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : País del cliente. |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2 |
− | : '''PATH''': | + | : '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode |
|- | |- | ||
− | | | + | |piso |
− | | | + | |String |
− | | | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Piso |
− | : '''PATH''': | + | : '''PATH''': ../cac:Address/cbc:Floor |
− | |||
|- | |- | ||
− | | | + | |region |
|String | |String | ||
− | | | + | |<nowiki>AN|..50</nowiki> |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Región |
− | + | : '''PATH''': ../cac:Address/cbc:Region | |
− | : '''PATH''': ../cac: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |subDivision |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..40</nowiki> |
− | |NO | + | |NO |
| | | | ||
− | : | + | : Subdivisión (Nombre del Barrio) |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:Address/cbc:CitySubdivisionName |
|- | |- | ||
− | | | + | |ubicación |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Una ubicación específica dentro de un edificio |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:Address/cbc:InhouseMail |
|- | |- | ||
− | | | + | |zonaPostal |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..10</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Zona Postal |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el contenido de este elemento no corresponde a un valor correspondiente de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]] |
− | | | + | : <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal. |
− | + | : '''PATH''': ../cac:Address/cbc:PostalZone | |
− | + | |} | |
− | | - | + | |
− | | | + | ====<font color="blue">Class.DocumentoReferencia</font>==== |
− | | | + | {| class="mw-collapsible mw-collapsed wikitable" |
− | : | + | ! style="background:#f2f2f2; text-align:center;"|Atributo |
− | : | + | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato |
− | : | + | ! style="background:#f2f2f2; text-align:center;"|Formato |
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |codigoEstatusDocumento |
|String | |String | ||
− | | | + | | - |
|C/C | |C/C | ||
| | | | ||
− | : | + | : Código o motivo del Documento |
− | : '''Obligatorio''' | + | : '''Obligatorio''' Cuando codigoInterno sea ‘4’ |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]] |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode |
|- | |- | ||
− | | | + | |codigoInterno |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|1</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores: |
− | : <span style="color:#FFFF; background:#FF0000"><b> | + | # AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles) |
− | + | # DespatchDocumentReference (Doc. De despacho) | |
+ | # ReceiptDocumentReference (Doc. De recepción) | ||
+ | # DiscrepancyResponse (N.C y N.D) | ||
+ | # BillingReference (Facturas por corrección, N.C y N.D) | ||
+ | :<span style="color:#FFFF; background:#FF0000"><b>OBLIGATORIO</b></span> '''Para Documento soporte este campo debe ser 5.''' | ||
|- | |- | ||
− | | | + | |cufeDocReferenciado |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..90</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : CUFE o CUDE del documento referenciado |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> | + | : '''Obligatorio''' Cuando codigoInterno sea ‘5’ |
− | : '''PATH''': | + | : '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura electrónica se origina a partir de la corrección o ajuste que se da mediante un NC o ND |
+ | : '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota. Solamente puede reportar facturas electrónicas de un mismo adquiriente | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si CUFE o CUDE no existe en la DIAN | ||
+ | : '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID | ||
+ | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID | ||
+ | : /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID | ||
|- | |- | ||
− | | | + | |descripcion |
− | |String | + | |Array <String> |
− | |<nowiki>AN|.. | + | |<nowiki>AN|20..5000</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Descripción de la naturaleza de la corrección |
− | : '''PATH''': ../cac: | + | : '''Obligatorio''' Cuando codigoInterno sea ‘4’ |
+ | : '''PATH''': ../cac:DiscrepancyResponse/cbc:Description | ||
|- | |- | ||
− | | | + | |extras |
− | + | |Array <Extensible> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor |
− | : | + | : '''PATH''': No definido |
+ | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |fecha |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|10</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Fecha de emision del documento referenciado, en formato: YYYY-MM-DD |
− | : '''PATH''': | + | : '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’ |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si fecha es posterior a la del documento referenciado | ||
+ | : '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate | ||
+ | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate | ||
+ | : /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference | ||
+ | : /cbc:IssueDate | ||
|- | |- | ||
− | | | + | |fechaFinValidez |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|10</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Fecha de Fin de Validez |
− | : '''PATH''': | + | : '''PATH''': No definido |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |fechaInicioValidez |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|10</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Fecha de Inicio de Validez |
− | : '''PATH''': | + | : '''PATH''': No definido |
|- | |- | ||
− | | | + | |numeroDocumento |
− | | | + | |String |
− | | | + | |<nowiki>AN..20</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Concatenación del prefijo y el número del documento referenciado |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado |
− | : | + | : '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID |
+ | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID | ||
+ | : /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference | ||
+ | : /cbc:ID | ||
|- | |- | ||
− | | | + | |tipoCUFE |
− | | | + | |String |
− | | | + | |<nowiki>AN|..11</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Algoritmo del tipo de CUFE. |
− | : '''PATH''': | + | : “CUFE-SHA384” ó “CUDE-SHA384” |
− | : | + | : '''Obligatorio''' Cuando codigoInterno sea ‘5’ |
+ | : '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference | ||
+ | : /cbc:UUID/@schemeName | ||
+ | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference | ||
+ | : /cbc:UUID/@schemeName | ||
+ | : /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference | ||
+ | : /cbc:UUID/@schemeName | ||
|- | |- | ||
− | | | + | |tipoDocumento |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Descripción del tipo de documento referenciado, Ejemplo: “Factura de Venta Nacional” |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>OBLIGATORIO</b></span> '''Para Documento soporte este campo debe ser 05.''' |
+ | : '''PATH''': No definido | ||
|- | |- | ||
− | | | + | |tipoDocumentoCodigo |
− | |String | + | |String |
− | |<nowiki>AN| | + | |<nowiki>AN|2</nowiki> |
|C/C | |C/C | ||
| | | | ||
− | : | + | : Identificador del tipo de documento referenciado |
− | : ''' | + | : '''Obligatorio''' Cuando codigoInterno sea ‘1’ |
− | : ''' | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]] |
+ | : '''Para Documento soporte este campo debe ser 05.''' | ||
+ | : '''PATH''': No definido | ||
+ | |} | ||
+ | '''''@IMPORTANTE:''' | ||
+ | # Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente: | ||
+ | #* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción. | ||
+ | #* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento. | ||
+ | # Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia). | ||
+ | # Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.'' | ||
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.DocumentoReferenciado</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |codigoEstatusDocumento |
|String | |String | ||
− | | | + | | - |
|C/C | |C/C | ||
| | | | ||
− | : | + | : Código o motivo del Documento |
− | : '''Obligatorio''' | + | : '''Obligatorio''' Cuando codigoInterno sea ‘4’ |
− | : '''PATH''': ../cbc: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este atributo no corresponde a algún de los valores de [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]] |
+ | : '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode | ||
|- | |- | ||
− | | | + | |codigoInterno |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|1</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores: |
− | + | # AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles) | |
− | + | # DespatchDocumentReference (Doc. De despacho) | |
− | + | # ReceiptDocumentReference (Doc. De recepción) | |
− | + | # DiscrepancyResponse (N.C y N.D) | |
− | + | # BillingReference (Facturas por corrección, N.C y N.D) | |
− | + | :<span style="color:#FFFF; background:#FF0000"><b>OBLIGATORIO</b></span> '''Para Documento soporte este campo debe ser 5.''' | |
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |cufeDocReferenciado |
|String | |String | ||
|<nowiki>AN|..90</nowiki> | |<nowiki>AN|..90</nowiki> | ||
− | | | + | |C/C |
| | | | ||
− | : | + | : CUFE o CUDE del documento referenciado |
− | : ''' | + | : '''Obligatorio''' Cuando codigoInterno sea ‘5’ |
− | + | : '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND | |
− | ''' | + | : '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota. |
− | + | : Solamente puede reportar facturas electrónicas de un mismo adquiriente | |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si CUFE o CUDE no existe en la DIAN | |
− | + | : '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID | |
− | + | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID | |
− | + | : /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID | |
− | |||
− | |||
|- | |- | ||
− | | | + | |descripcion |
− | |String | + | |Array <String> |
− | | | + | |<nowiki>AN|20..5000</nowiki> |
− | + | |C/C | |
− | |||
| | | | ||
− | : | + | : Descripción de la naturaleza de la corrección |
− | + | : '''Obligatorio''' Cuando codigoInterno sea ‘4’ | |
− | + | : '''PATH''': ../cac:DiscrepancyResponse/cbc:Description | |
− | : ''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | : '''PATH''': | ||
|- | |- | ||
|extras | |extras | ||
− | |Array <Extensible> | + | |Array <Extensible> |
| - | | - | ||
|NO | |NO | ||
Línea 2278: | Línea 2308: | ||
: (ver detalle en [[#Class.Extensible|Class.Extensible]]) | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |fecha |
|String | |String | ||
|<nowiki>AN|10</nowiki> | |<nowiki>AN|10</nowiki> | ||
− | | | + | |C/C |
| | | | ||
− | : Fecha | + | : Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD |
− | : '''PATH''': | + | : '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’ |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si fecha es posterior a la del documento referenciado | ||
+ | : '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate | ||
+ | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate | ||
+ | : /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference | ||
+ | : /cbc:IssueDate | ||
|- | |- | ||
− | | | + | |fechaFinValidez |
|String | |String | ||
− | | | + | |<nowiki>AN|10</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Fecha de Fin de Validez |
− | : '''PATH''': | + | : '''PATH''': No definido |
|- | |- | ||
− | | | + | |fechaInicioValidez |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|10</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Fecha de Inicio de Validez |
− | + | : '''PATH''': No definido | |
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |numeroDocumento |
|String | |String | ||
− | |<nowiki>AN | + | |<nowiki>AN..20</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : Concatenación del prefijo y el número del documento referenciado |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado |
− | '''PATH''': | + | : '''PATH''': |
+ | : /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID | ||
+ | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID | ||
+ | : /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference | ||
+ | : /cbc:ID | ||
|- | |- | ||
− | | | + | |tipoCUFE |
|String | |String | ||
− | | | + | |<nowiki>AN|..11</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Algoritmo del tipo de CUFE. |
− | : '''PATH''': | + | : “CUFE-SHA384” ó “CUDE-SHA384” |
+ | : '''Obligatorio''' Cuando codigoInterno sea ‘5’ | ||
+ | : '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName | ||
+ | : /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName | ||
+ | : /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName | ||
|- | |- | ||
− | | | + | |tipoDocumento |
− | |String | + | |String |
− | | | + | |<nowiki>AN|..50</nowiki> |
− | + | |NO | |
− | | | + | | |
+ | : Descripción del tipo de documento referenciado, | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>OBLIGATORIO</b></span> '''Para Documento soporte este campo debe ser 05.''' | ||
+ | : Ejemplo: “Factura de Venta Nacional” | ||
+ | : '''PATH''': No definido | ||
+ | |- | ||
+ | |tipoDocumentoCodigo | ||
+ | |String | ||
+ | |<nowiki>AN|2</nowiki> | ||
+ | |C/C | ||
| | | | ||
− | : | + | : Identificador del tipo de documento referenciado. |
− | : | + | : '''Obligatorio''' Cuando codigoInterno sea ‘1’ |
− | : '''PATH''': | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]] |
+ | : '''Nota''': Para ordenes de remisión, informar el código ‘AAJ’ | ||
+ | : '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode | ||
+ | : / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode | ||
+ | : / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode | ||
+ | : '''Para Documento soporte este campo debe ser 05.''' | ||
|} | |} | ||
− | ====Class. | + | |
+ | '''@IMPORTANTE:''' | ||
+ | ''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente: | ||
+ | #* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc. | ||
+ | #* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento. | ||
+ | # Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia). | ||
+ | # Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.'' | ||
+ | |||
+ | ====<font color="blue">Class.EntregaMercancia</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 2338: | Línea 2402: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |datosTransportistas |
− | | | + | |DatoTransportistas |
− | | | + | | - |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Datos del Transportista |
− | : | + | : '''PATH''': ../cac:DeliveryParty |
− | : | + | : (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]]) |
− | : '''PATH''': ../ | + | |- |
+ | |direccionDespacho | ||
+ | |Direccion | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | : Información de Despacho | ||
+ | : '''PATH''': ../cac:Despatch/cac:DespatchAddress | ||
+ | : (ver detalle en [[#Class.Direccion|Class.Direccion]]) | ||
|- | |- | ||
− | | | + | |direccionEntrega |
− | | | + | |Direccion |
− | | | + | | - |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Información de Entrega |
− | + | : '''PATH''': ../cac:DeliveryAddress | |
− | + | : (ver detalle en [[#Class.Direccion|Class.Direccion]]) | |
− | : '''PATH''': | ||
|- | |- | ||
|extras | |extras | ||
− | |Array | + | |Array <Extensible> |
| - | | - | ||
|NO | |NO | ||
Línea 2369: | Línea 2438: | ||
: (ver detalle en [[#Class.Extensible|Class.Extensible]]) | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |fechaEfectivaSalida |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|19</nowiki> |
− | | | + | |NO |
| | | | ||
− | : Fecha | + | : Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS |
− | : '''PATH''': ../cbc: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha efectiva de salida es anterior a la fecha de emisión |
+ | : '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime | ||
|- | |- | ||
− | | | + | |fechaEstimada |
|String | |String | ||
− | | | + | |<nowiki>AN|19</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS |
− | : '''PATH''': ../cbc: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha estimada es anterior a la fecha de emisión |
+ | : '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime | ||
|- | |- | ||
− | | | + | |fechaReal |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|19</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Fecha real, en formato: YYYY-MM-DD HH:MM:SS |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha real es anterior a la fecha de emisión |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime |
|- | |- | ||
− | | | + | |fechaSolicitada |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|19</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha solicitada es anterior a la fecha de emisión |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime |
|- | |- | ||
− | | | + | |identificacionTransporte |
|String | |String | ||
− | | | + | |<nowiki>AN|..20</nowiki> |
− | |NO | + | |NO |
| | | | ||
− | : | + | : Datos del Transporte |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:Despatch/cbc:ID |
|- | |- | ||
− | | | + | |matriculaTransporte |
− | |String | + | |String |
− | | | + | |<nowiki>AN|..20</nowiki> |
− | + | |NO | |
− | | | ||
| | | | ||
− | : | + | : Matricula del Transporte |
− | + | : '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID | |
− | : '''PATH''': ../cbc: | ||
|} | |} | ||
− | ====Class. | + | |
+ | ====<font color="blue">Class.Extras</font >==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 2429: | Línea 2499: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |controlInterno1 |
− | | | + | |String |
− | | | + | |<nowiki>AN|100</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Etiqueta asignada para la Representación Impresa PDF. |
− | : '''PATH''': | + | : '''PATH''': Variable |
− | |||
|- | |- | ||
− | | | + | |controlInterno2 |
|String | |String | ||
− | | | + | |Depende del Campo |
|C/C | |C/C | ||
| | | | ||
− | : | + | : Permite asociar dos o más campos mediante un índice (si los campos son asociables) |
− | + | : '''PATH''': Variable | |
− | |||
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |nombre |
|String | |String | ||
− | | | + | |Depende del Campo |
− | | | + | |SI |
| | | | ||
− | : | + | : Código del campo extensible a referenciar |
− | : '''PATH''': | + | : (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]]) |
+ | : '''PATH''': Variable | ||
|- | |- | ||
− | | | + | |pdf |
− | | | + | |String |
− | | | + | |<nowiki>N|1</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Indicación de mostrar el campo en la representación gráfica PDF |
− | : '''PATH''': | + | : (“0” = No mostrar / “1” = Mostrar) |
− | + | : '''PATH''': Variable | |
|- | |- | ||
− | | | + | |valor |
− | | | + | |String |
− | | | + | |Depende del Campo |
− | | | + | |SI |
| | | | ||
− | : | + | : Valor del campo a agregar |
− | : '''PATH''': | + | : '''PATH''': Variable |
− | |||
|- | |- | ||
− | | | + | |xml |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|1</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Indicación de mostrar el campo en el XML |
− | + | : (“0” = No mostrar / “1” = Mostrar) | |
− | + | : '''PATH''': Variable | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | : | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | : '''PATH''': | ||
|} | |} | ||
− | ====Class. | + | |
+ | ====<font color="blue">Class.Extensible</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 2507: | Línea 2559: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |controlInterno1 |
− | |String | + | |String |
− | |<nowiki>AN| | + | |<nowiki>AN|100</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Etiqueta asignada para la Representación Impresa PDF. |
− | : '''PATH''': | + | : '''PATH''': Variable |
|- | |- | ||
− | | | + | |controlInterno2 |
|String | |String | ||
− | | | + | |Depende del Campo |
− | + | |C/C | |
| | | | ||
− | : | + | : Permite asociar dos o más campos mediante un índice (si los campos son asociables) |
− | : '''PATH''': | + | : '''PATH''': Variable |
|- | |- | ||
− | | | + | |nombre |
|String | |String | ||
− | | | + | |Depende del Campo |
− | | | + | |SI |
| | | | ||
− | : | + | : Código del campo extensible a referenciar |
− | : '''PATH''': | + | : '''PATH''': Variable |
|- | |- | ||
− | | | + | |valor |
|String | |String | ||
− | | | + | |Depende del Campo |
− | | | + | |SI |
| | | | ||
− | : | + | : Valor del campo a agregar |
− | : '''PATH''': . | + | : '''PATH''': Variable |
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.FacturaImpuestos</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |baseImponibleTOTALImp |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Base Imponible sobre la que se calcula el valor del tributo |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount |
|- | |- | ||
− | | | + | |codigoTOTALImp |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|2</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Identificador del tributo |
− | : '''PATH''': ../cac: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]] |
+ | : '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID | ||
|- | |- | ||
− | | | + | |controlInterno |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|1</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Indicador de tipo de retención |
− | + | : '''PATH''': No Definido | |
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |extras |
− | + | |Array <Extensible> | |
− | |< | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor |
− | + | : '''PATH''': No definido | |
− | : ''' | + | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) |
− | : | ||
|- | |- | ||
− | | | + | |porcentajeTOTALImp |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..2</nowiki> |
− | | | + | Dec: <nowiki>N|2*</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Tarifa del tributo. |
− | : '''PATH''': ../cac: | + | : En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa “porcentaje” a ser aplicada a la base imponible |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si reporta una tarifa diferente para uno de los tributos enunciados en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]] | ||
+ | : '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent | ||
|- | |- | ||
− | | | + | |unidadMedida |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|..5</nowiki> |
− | |SI | + | |SI |
| | | | ||
− | : | + | : Identificación de la unidad de medida |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]] |
− | : '''PATH''': ../cac: | + | : '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode |
|- | |- | ||
− | | | + | |unidadMedidaTributo |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..2</nowiki> |
− | | | + | Dec: <nowiki>N|2</nowiki> |
+ | |C/C | ||
| | | | ||
− | : | + | : Unidad de medida base para el tributo |
− | : '''PATH''': ../cac: | + | : '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado | ||
+ | : '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure | ||
|- | |- | ||
− | | | + | |valorTOTALImp |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
+ | Dec: <nowiki>N|0..6</nowiki> | ||
|SI | |SI | ||
| | | | ||
− | : | + | : Valor del tributo. Producto del porcentaje aplicado sobre la base imponible |
− | : '''PATH''': ../cac: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades | ||
+ | : '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount | ||
|- | |- | ||
− | | | + | |valorTributoUnidad |
− | |String | + | |String |
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |C/C | ||
| | | | ||
− | : | + | : Es el valor nominal del tributo por unidad |
− | : '''PATH''': /cac: | + | : '''Obligatorio''' En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si el elemento unidadMedidaTributo NO es informado. | ||
+ | : '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount | ||
+ | |} | ||
+ | |||
+ | '''@IMPORTANTE''': Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104. | ||
+ | |||
+ | ====<font color="blue">Class.ImpuestosTotales</font >==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- | ||
+ | |codigoTOTALImp | ||
+ | |String | ||
+ | |<nowiki>AN|2</nowiki> | ||
+ | |SI | ||
+ | | | ||
+ | : Identificador del tributo | ||
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]] | ||
+ | : '''PATH''': Por Definir | ||
|- | |- | ||
|extras | |extras | ||
Línea 2624: | Línea 2717: | ||
: (ver detalle en [[#Class.Extensible|Class.Extensible]]) | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |montoTotal |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | + | Dec: <nowiki>N|0..6</nowiki> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|SI | |SI | ||
| | | | ||
− | : | + | : Suma de todos los atributos valorTOTALImp |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp | |
− | : <span style="color:#FFFF; background:#FF0000"><b> | + | : '''PATH''': ../cac:TaxTotal/cbc:TaxAmount |
− | : '''PATH''': /cac: | + | |} |
+ | |||
+ | ====<font color="blue">Class.InformacionLegalCliente</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |codigoEstablecimiento |
− | | | + | |String |
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Código de Establecimiento |
− | : | + | : <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode |
− | : | ||
|- | |- | ||
− | | | + | |nombreRegistroRUT |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..450</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : Nombre o Razón Social del adquirente |
− | : | + | : '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor. |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName |
|- | |- | ||
− | | | + | |numeroIdentificacion |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..12</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Identificador del Adquirente. |
− | : '''PATH''': ../cac: | + | : Debe informar el NIT si es responsable |
+ | : '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID | ||
|- | |- | ||
− | | | + | |numeroIdentificacionDV |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|..2</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Digito Verificador |
− | : '''PATH''': ../cac: | + | : '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado |
+ | : '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID | ||
|- | |- | ||
− | | | + | |numeroMatriculaMercantil |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|9</nowiki> |
|NO | |NO | ||
| | | | ||
− | : Número de | + | : Número de matrícula mercantil |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name |
|- | |- | ||
− | | | + | |prefijoFacturacion |
|String | |String | ||
− | | | + | | - |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|NO | |NO | ||
| | | | ||
− | : | + | : Prefijo de facturación: |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID |
|- | |- | ||
− | | | + | |tipoIdentificacion |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|2</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Tipo de identificación del cliente |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento es diferente de “31” | |
− | + | : '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | : <span style="color:#FFFF; background:#FF0000"><b> | ||
− | |||
− | : '''PATH''': ../cac: | ||
|} | |} | ||
− | ====Class. | + | |
+ | ====<font color="blue">Class.LineaInformacionAdicional</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 2743: | Línea 2805: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |cantidad |
|String | |String | ||
− | | | + | |<nowiki>AN|..5</nowiki> |
− | |NO | + | |NO |
| | | | ||
− | : | + | : Cantidad adicional |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cbc:ValueQuantity |
|- | |- | ||
− | | | + | |codigo |
|String | |String | ||
− | | | + | |<nowiki>AN|..5</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Código adicional |
− | + | : '''PATH''': ../cbc:NameCode | |
− | : '''PATH''': ../cbc: | ||
|- | |- | ||
− | | | + | |codigoInterno1 |
|String | |String | ||
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Opcional sin uso por ahora |
− | : '''PATH''': | + | : '''PATH''': No definido |
|- | |- | ||
− | | | + | |codigoInterno2 |
|String | |String | ||
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Opcional sin uso por ahora |
− | + | : '''PATH''': No definido | |
− | : '''PATH''': | ||
|- | |- | ||
− | | | + | |descripcion |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|..450</nowiki> |
− | |NO | + | |NO |
| | | | ||
− | : | + | : Descripción adicional |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:UsabilityPeriod/cbc:Description |
|- | |- | ||
− | | | + | |fechaFin |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|10</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Fecha final del período |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate |
− | + | |- | |
− | + | |fechaInicio | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |- | ||
− | | | ||
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|10</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Fecha inicial del período |
− | + | : '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate | |
− | : '''PATH''': ../cbc: | ||
|- | |- | ||
− | | | + | |nombre |
− | | | + | |String |
− | | | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Característica que quiere informar del ítem, por ejemplo: (Uso Vehículo) |
− | : | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Por cada nombre debe existir un valor |
− | + | : '''PATH''': ../cbc:Name | |
− | + | : (Por definir catálogos de campos extensibles a nivel de detalle) | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |secuencia |
|String | |String | ||
− | | | + | |<nowiki>AN|..3</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Indicador de orden de secuencia |
− | : | + | : '''PATH''': No definido |
|- | |- | ||
− | | | + | |tipo |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>N|1</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Indicador de Tipo de Valor, ejemplo Valor = ’1’ |
− | : '''PATH''': | + | : '''PATH''': No aplica |
|- | |- | ||
− | | | + | |valor |
− | |String | + | |String |
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Valor de la característica que se quiere informar, por ejemplo :(Particular) |
− | : | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Por cada valor debe existir un name |
− | : '''PATH''': | + | : '''PATH''': ../cbc:Value |
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.MediosDePago</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |codigoBanco |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|..20</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Código del Banco o Entidad Financiera |
− | + | : '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode | |
− | : '''PATH''': ../cac: | + | |- |
− | |- | + | |codigoCanalPago |
− | | | ||
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Código del canal del pago |
− | : '''PATH''': .. | + | : '''PATH''': ../cbc:PaymentChannelCode |
|- | |- | ||
− | | | + | |codigoReferencia |
|String | |String | ||
− | | | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Opcional sin uso por ahora |
− | : '''PATH''': | + | : '''PATH''': No definido |
|- | |- | ||
− | + | |extras | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |extras | ||
|Array <Extensible> | |Array <Extensible> | ||
| - | | - | ||
|NO | |NO | ||
| | | | ||
− | : Campos o información opcional para el modelo de negocio del emisor | + | : Campos o información opcional para el modelo de negocio del emisor. |
: '''PATH''': No definido | : '''PATH''': No definido | ||
: (ver detalle en [[#Class.Extensible|Class.Extensible]]) | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |fechaDeVencimiento |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|19</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Fecha de Vencimiento del pago de la factura en formato: YYYY-MM-DD |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> | + | : '''Obligatorio''' Si la venta es a crédito |
− | : '''PATH''': ../cbc: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si código del método de pago es “2” y no se envía la fecha de vencimiento |
+ | : '''PATH''': ../cbc:PaymentDueDate | ||
|- | |- | ||
− | | | + | |medioPago |
|String | |String | ||
− | |<nowiki>AN|2</nowiki> | + | |<nowiki>AN|..2</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Código correspondiente al medio de pago |
− | : | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]] |
− | : | + | : '''PATH''': ../cbc:PaymentMeansCode |
− | : '''PATH''': .. /cbc: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |metodoDePago |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..2</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Método de Pago |
− | : '''PATH''': ../cbc: | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]] |
+ | : '''PATH''': ../cbc:ID | ||
|- | |- | ||
− | | | + | |nombreBanco |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..50</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Nombre del Banco o Entidad Financiera |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name |
|- | |- | ||
− | | | + | |numeroDeReferencia |
|String | |String | ||
− | | | + | |<nowiki>AN|..200</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Identificador o referencia interna del Pago |
− | : ''' | + | : PATH''':''' ../cbc:PaymentID |
|- | |- | ||
− | | | + | |numeroDias |
|String | |String | ||
− | | | + | |<nowiki>N|..3</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Número de días para el pago |
− | : '''PATH''': | + | : '''PATH''': ../cbc:InstructionNote |
|- | |- | ||
− | | | + | |numeroTransferencia |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Número de ransferência o número de cheque |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID |
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.Obligaciones</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |extras |
− | + | |Array <Extensible> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor |
− | : '''PATH''': .. | + | : '''PATH''': No definido |
+ | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |obligaciones |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|7</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Obligaciones del adquiriente |
− | : '''PATH''': .. | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]] |
+ | : '''PATH''': ../cbc:TaxLevelCode | ||
|- | |- | ||
− | | | + | |regimen |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|2</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Opcional, si informado indicar “No aplica”. Posibles Valores: |
− | : | + | : 48: “Impuesto sobre las ventas - IVA” |
− | : '''PATH''': ../cbc: | + | : 49: “No responsable de IVA” |
− | : | + | : '''PATH''': .. /cbc:TaxLevelCode/@listName |
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.OrdenDeCompra</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |codigoCliente |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Código del cliente |
− | : '''PATH''': | + | : '''PATH''': ../cbc:CustomerReference |
|- | |- | ||
− | | | + | |documentoReferencia |
− | | | + | |DocumentoReferencia |
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Documento Referencia |
− | : '''PATH''': | + | : '''PATH''': ../cac:DocumentReference |
+ | : (ver detalle en [[#Class.DocumentoReferencia|Class.DocumentoReferencia]]) | ||
|- | |- | ||
− | | | + | |extras |
− | + | |Array <Extensible> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor |
− | + | : '''PATH''': No definido | |
− | : '''PATH''': . | + | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) |
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |fecha |
− | | | + | |String |
− | | | + | |<nowiki>AN|10</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS |
− | : '''PATH''': ../ | + | : '''PATH''': ../cbc:IssueDate |
− | |||
|- | |- | ||
− | | | + | |numeroOrden |
− | | | + | |String |
− | | | + | |<nowiki>AN|..20</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Número de la Orden de Compra |
− | : '''PATH''': .. | + | : '''Obligatorio''' Para enviar la Orden de Compra |
− | + | : '''PATH''': ../cbc:ID | |
|- | |- | ||
− | | | + | |numeroPedido |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..20</nowiki> |
− | | | + | |C/C |
| | | | ||
− | : | + | : Número del Pedido |
− | : '''PATH''': .. | + | : '''Obligatorio''' Para enviar el Pedido |
+ | : '''PATH''': ../cbc:SalesOrderID | ||
|- | |- | ||
− | | | + | |tipoCUFE |
− | | | + | |String |
− | | | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Identificador del tipo de CUFE |
− | : '''PATH''': | + | : '''PATH''': ../cbc:UUID@schemeName |
− | |||
|- | |- | ||
− | | | + | |tipoOrden |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..20</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : Tipo de Orden |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cbc:OrderTypeCode |
|- | |- | ||
− | | | + | |uuid |
|String | |String | ||
− | |<nowiki>AN|.. | + | |<nowiki>AN|..90</nowiki> |
|NO | |NO | ||
| | | | ||
− | : | + | : UUID de algún documento referenciado |
− | : '''PATH''': ../cbc: | + | : '''PATH''': ../cbc:UUID |
+ | |} | ||
+ | |||
+ | '''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference. | ||
+ | |||
+ | ====<font color="blue">Class.sectorSalud</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |Beneficiario |
− | | | + | |Beneficiario |
− | | | + | | - |
− | + | |C/C | |
| | | | ||
− | : | + | : Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo. |
− | : '''PATH''': .. /cac: | + | : '''PATH''': ../cac:AccountingCustomerParty/cac:Person |
+ | : (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]]) | ||
|- | |- | ||
− | | | + | |extras |
− | + | |Array <Extras> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor. |
− | : '''PATH''': .. | + | : '''PATH''': No definido |
+ | : (ver detalle en [[#Class.Extras|Class.Extras]]) | ||
|- | |- | ||
− | | | + | |IdPersonalizacion |
|String | |String | ||
+ | |Por definir | ||
+ | |C/C | ||
+ | | | ||
+ | : Para indicar tipo de operacion a traves de la cual se realizó el recaudo en los escenarios de acreditación o reporte | ||
+ | : '''PATH''': Por definir | ||
+ | |- | ||
+ | |Pacientes | ||
+ | |Array <DatosPacienteSalud> | ||
| - | | - | ||
− | | | + | |C/C |
− | | | + | |Para el reporte de los campos de datos adicionales del Sector Salud |
− | + | : (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]) | |
− | : | ||
|- | |- | ||
− | | | + | |TipoEscenario |
− | |String | + | |String |
− | |<nowiki> | + | |<nowiki> N|1 </nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]] |
− | : | + | |} |
+ | <span style="color:#FFFF; background:#FF0000"><b>NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.</b></span> | ||
+ | |||
+ | ====<font color="blue">Class.Beneficiario</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |DireccionResidencia |
− | | | + | |Direccion |
− | | | + | | - |
− | + | |C/C | |
| | | | ||
− | : | + | : Información donde se detalle la dirección del beneficiario del servicio de salud. |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:ResidenceAddress |
+ | : (ver detalle en [[#Class.Direccion|Class.Direccion]]) | ||
|- | |- | ||
− | | | + | |TipoIdentificacion |
− | + | |Array <GeneralSalud> | |
− | |< | + | | - |
− | | | + | |C/C |
| | | | ||
− | : | + | : Tipo de Identificación del usuario beneficiario del servicio de salud. |
− | : '''PATH''': . | + | : '''PATH''': cbc:ID/@schemeID |
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.DatosPacientesSalud</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |CamposGenerales |
− | + | |Array <GeneralSalud> | |
− | |< | + | | - |
− | | | + | |C/C |
| | | | ||
− | : | + | : Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud |
− | : '''PATH''': | + | : '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension |
+ | : (ver detalle en [[#Class.Direccion|Class.Direccion]]) | ||
|- | |- | ||
− | | | + | |TipoIdentificacion |
− | |Array < | + | |Array <GeneralSalud> |
| - | | - | ||
− | | | + | |C/C |
| | | | ||
− | : | + | : Tipo de Identificación del usuario beneficiario del servicio de salud. |
− | : '''PATH''': | + | : '''PATH''': cbc:ID/@schemeID |
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]]) |
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.GeneralSalud</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |nombre |
|String | |String | ||
− | | | + | |N|..2 |
− | | | + | |Si |
| | | | ||
− | : | + | : Código del campo de dato adicional. |
− | : '''PATH''': ../ | + | : '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name |
+ | : <span style="color:#FFFF; background:#FF0000"><b>@Nota:</b></span> Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]] | ||
+ | |||
|- | |- | ||
− | | | + | |valor |
|String | |String | ||
− | | | + | |Depende del campo |
− | | | + | |Si |
| | | | ||
− | : | + | : Valor del campo de datos adicional del sector salud según corresponda. |
− | : '''PATH''': ../ | + | : '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value |
− | + | |} | |
− | + | ||
− | + | '''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo). | |
− | + | ||
− | | | + | En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web. |
− | | | + | * Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo: |
− | : Tipo | + | :: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1" |
− | + | :: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2" | |
− | : | + | :: ... |
+ | :: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000" | ||
+ | |||
+ | *Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo: | ||
+ | :: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1" | ||
+ | :: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2" | ||
+ | :: ... | ||
+ | :: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000" | ||
+ | |||
+ | |||
+ | ====<font color="blue">Class.TasaDeCambio</font>==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |baseMonedaDestino |
− | | | + | |String |
− | | | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Base monetaria para la conversión. |
− | : '''PATH''': ../ | + | : Debe ser 1.00 |
− | : | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00 |
+ | : '''PATH''': ../cbc:TargetCurrencyBaseRate | ||
|- | |- | ||
− | | | + | |baseMonedaOrigen |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Base monetaria de la divisa extranjera para el cambio. |
− | : '''PATH''': .. | + | : Debe ser 1.00 |
+ | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00 | ||
+ | : '''PATH''': ../cbc:SourceCurrencyBaseRate | ||
|- | |- | ||
− | | | + | |extras |
− | + | |Array <Extensible> | |
− | |< | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor |
− | : '''PATH''': .. | + | : '''PATH''': No definido |
+ | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |fechaDeTasaDeCambio |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|10</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD |
− | : '''PATH''': .. | + | : '''PATH''': ../cbc:Date |
|- | |- | ||
− | | | + | |indicadorDeTasa |
|String | |String | ||
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Indicador de Tasa de Cambio |
− | : '''PATH''': .. | + | : '''PATH''': ../cbc:ExchangeMarketID |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |monedaDestino |
|String | |String | ||
− | | | + | |<nowiki>AN|3</nowiki> |
− | | | + | |SI |
| | | | ||
− | : Código | + | : Código de moneda destino del documento. |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no es ‘COP’ | |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este | + | : '''PATH''': ../cbc:TargetCurrencyCode |
− | : '''PATH''': .. | ||
|- | |- | ||
− | | | + | |monedaOrigen |
|String | |String | ||
− | |<nowiki> | + | |<nowiki>AN|3</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : Código de moneda base del documento |
− | # | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde al estándar ISO-4217 |
− | + | '''PATH''': ../cbc:SourceCurrencyCode | |
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |operadorCalculo |
|String | |String | ||
− | | | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | : Operador de Calculo |
− | : ''' | + | : '''PATH''': ../cbc: MathematicOperatorCode |
− | |||
− | : | ||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |tasaDeCambio |
− | | | + | |String |
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio. |
− | : | + | : Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino) |
− | : '''PATH''': ../ | + | : '''PATH''': ../cbc:CalculationRate |
+ | |} | ||
+ | |||
+ | ====<font color="blue">Class.TasaDeCambioAlternativa</font >==== | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo Dato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Formato | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Requerido | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |baseMonedaDestino |
− | | | + | |String |
− | | | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Base monetaria para la conversión. |
− | : '''PATH''': | + | : Debe ser 1.00 |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00 | |
+ | : '''PATH''': ../cbc:TargetCurrencyBaseRate | ||
|- | |- | ||
− | | | + | |baseMonedaOrigen |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Base monetaria de la divisa extranjera para el cambio. |
− | : | + | : Debe ser 1.00 |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00 |
− | : '''PATH''': | + | : '''PATH''': ../cbc:SourceCurrencyBaseRate |
− | : | + | |- |
− | : | + | |extras |
− | : | + | |Array <Extensible> |
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | : Campos o información opcional para el modelo de negocio del emisor | ||
+ | : '''PATH''': No definido | ||
+ | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) | ||
|- | |- | ||
− | | | + | |fechaDeTasaDeCambio |
|String | |String | ||
|<nowiki>AN|10</nowiki> | |<nowiki>AN|10</nowiki> | ||
− | | | + | |SI |
| | | | ||
− | : Fecha de | + | : Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD |
− | : '''PATH''': | + | : '''PATH''': ../cbc:Date |
|- | |- | ||
− | | | + | |indicadorDeTasa |
|String | |String | ||
− | | | + | | - |
|NO | |NO | ||
| | | | ||
− | : | + | : Indicador de Tasa de Cambio |
− | : '''PATH''': | + | : '''PATH''': ../cbc:ExchangeMarketID |
|- | |- | ||
− | | | + | |monedaDestino |
|String | |String | ||
− | |<nowiki>AN | + | |<nowiki>AN|3</nowiki> |
|SI | |SI | ||
| | | | ||
− | : | + | : Código de moneda destino del documento. |
− | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no es ‘COP’ |
− | : '''PATH''': | + | : '''PATH''': ../cbc:TargetCurrencyCode |
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |monedaOrigen |
|String | |String | ||
− | |<nowiki>AN| | + | |<nowiki>AN|3</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Código de moneda base del documento |
− | : | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde al estándar ISO-4217 |
− | + | : '''PATH''': ../cbc:SourceCurrencyCode | |
− | : '''PATH''': | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |operadorCalculo |
|String | |String | ||
− | | | + | | - |
− | |NO | + | |NO |
| | | | ||
− | : | + | : Operador de Calculo |
− | : '''PATH''': | + | : '''PATH''': ../cbc: MathematicOperatorCode |
|- | |- | ||
− | | | + | |tasaDeCambio |
|String | |String | ||
− | |<nowiki> | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |SI | ||
| | | | ||
− | : | + | : Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio. |
− | : | + | : Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino) |
− | + | : '''PATH''': ../cbc:CalculationRate | |
− | : '''PATH''': | ||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ====Class. | + | ====<font color="blue">Class.TerminosEntrega</font>==== |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 3361: | Línea 3461: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |cargosDescuentos |
− | | | + | |Array <CargosDescuentos> |
− | | - | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | : Informaciones relacionadas con un cargo o un descuento |
− | : '''PATH''': ../cac: | + | : '''PATH''': ../cac:AllowanceCharge |
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]]) |
|- | |- | ||
− | | | + | |codigoCondicionEntrega |
− | | | + | |String |
− | | | + | |<nowiki>AN|3</nowiki> |
|C/C | |C/C | ||
| | | | ||
− | : | + | : Código de Condiciones de Entrega |
− | : ''' | + | : '''Obligatorio''' Se es factura de exportación/internacional |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si el valor de este atributo no corresponde a un valor de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]] | |
+ | : '''PATH''': ../cbc:LossRiskResponsibilityCode | ||
|- | |- | ||
− | | | + | |costoTransporte |
|String | |String | ||
− | |Por | + | |Por Definir |
− | | | + | |NO |
| | | | ||
− | : | + | : Método de pago del transporte: Se utiliza para indicar como se pagan los costes del transporte, por ejemplo: http://www.unece.org/ |
− | : '''PATH''': | + | : '''PATH''': ../cbc: SpecialTerms |
+ | |- | ||
+ | |direccionEntrega | ||
+ | |Class.Direccion | ||
+ | | - | ||
+ | |NO | ||
+ | | | ||
+ | : Información donde se detalle la dirección de entrega | ||
+ | : '''PATH''': ../cac:DeliveryLocation | ||
+ | : (ver detalle en [[#Class.Direccion|Class.Direccion]]) | ||
|- | |- | ||
|extras | |extras | ||
− | |Array < | + | |Array <Extensible> |
| - | | - | ||
|NO | |NO | ||
| | | | ||
: Campos o información opcional para el modelo de negocio del emisor. | : Campos o información opcional para el modelo de negocio del emisor. | ||
− | : '''PATH''': No definido | + | : '''PATH''': No definido |
− | : (ver detalle en [[#Class. | + | : (ver detalle en [[#Class.Extensible|Class.Extensible]]) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |identificacion |
− | | | + | |String |
− | | | + | |<nowiki>AN|..12</nowiki> |
− | | | + | |NO |
| | | | ||
− | : | + | : Numero Identificación |
− | : '''PATH''': ../ | + | : '''PATH''': ../cbc:ID |
− | |||
|- | |- | ||
− | | | + | |monto |
− | | | + | |String |
− | | - | + | |Ent: <nowiki>N|..15</nowiki> |
− | | | + | Dec: <nowiki>N|0..6</nowiki> |
+ | |NO | ||
+ | | | ||
+ | : Monto | ||
+ | : '''PATH''': ../cbc:Amount | ||
+ | |- | ||
+ | |responsableEntrega | ||
+ | |String | ||
+ | |<nowiki>AN|..50</nowiki> | ||
+ | |NO | ||
| | | | ||
− | : | + | : Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda |
− | : '''PATH''': cbc: | + | : '''PATH''': ../cbc:LossRisk |
− | |||
|} | |} | ||
− | ====Class. | + | |
+ | ====<font color="blue">Class.Tributos</font>==== | ||
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
! style="background:#f2f2f2; text-align:center;"|Atributo | ! style="background:#f2f2f2; text-align:center;"|Atributo | ||
Línea 3431: | Línea 3540: | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- | |- | ||
− | | | + | |codigoImpuesto |
|String | |String | ||
− | | | + | |<nowiki>AN|2</nowiki> |
− | | | + | |SI |
| | | | ||
− | : | + | : Identificador del tributo |
− | + | : <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]] | |
− | + | : '''PATH''': ../cbc:ID | |
− | : <span style="color:#FFFF; background:#FF0000"><b> | ||
− | |||
|- | |- | ||
− | | | + | |extras |
− | | | + | |Array <Extensible> |
− | | | + | | - |
− | | | + | |NO |
| | | | ||
− | : | + | : Campos o información opcional para el modelo de negocio del emisor. |
− | : '''PATH''': .. | + | : '''PATH''': No definido (ver detalle en [[#Class.Extensible|Class.Extensible]]) |
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
Línea 3541: | Línea 3632: | ||
{{clear}} | {{clear}} | ||
− | ===Método EstadoDocumento=== | + | ===<font color="blue">Método EstadoDocumento</font>=== |
Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor. | Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor. | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 3910: | Línea 4001: | ||
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización. | '''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización. | ||
{{clear}} | {{clear}} | ||
− | ===Método EnvioCorreo=== | + | ===<font color="blue">Método EnvioCorreo</font>=== |
Permite reenviar a una o varias direcciones de correos el documento indicado. | Permite reenviar a una o varias direcciones de correos el documento indicado. | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 3957: | Línea 4048: | ||
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método '''CargarAdjuntos''' del Servicio Adjuntos Web SOAP. | '''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método '''CargarAdjuntos''' del Servicio Adjuntos Web SOAP. | ||
{{clear}} | {{clear}} | ||
− | ===Método DescargaPDF=== | + | ===<font color="blue">Método DescargaPDF</font>=== |
Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión. | Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión. | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 4009: | Línea 4100: | ||
'''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP). | '''@Importante:''' Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP). | ||
{{clear}} | {{clear}} | ||
− | ===Método DescargaXML=== | + | ===<font color="blue">Método DescargaXML</font>=== |
Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local. | Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local. | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 4060: | Línea 4151: | ||
|} | |} | ||
{{clear}} | {{clear}} | ||
− | ===Método FoliosRestantes=== | + | ===<font color="blue">Método FoliosRestantes</font>=== |
Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas. | Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas. | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 4100: | Línea 4191: | ||
|} | |} | ||
{{clear}} | {{clear}} | ||
− | ===Método CargarCertificado=== | + | ===<font color="blue">Método CargarCertificado</font>=== |
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia. | Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia. | ||
{{clear}} | {{clear}} | ||
− | ===Método DescargarEventoXML=== | + | ===<font color="blue">Método DescargarEventoXML</font>=== |
Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente). | Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente). | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 4166: | Línea 4257: | ||
|} | |} | ||
{{clear}} | {{clear}} | ||
− | ===Método GenerarContenedor=== | + | ===<font color="blue">Método GenerarContenedor</font>=== |
Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha. | Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha. | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 4217: | Línea 4308: | ||
|} | |} | ||
{{clear}} | {{clear}} | ||
− | ===Método GenerarEvento=== | + | ===<font color="blue">Método GenerarEvento</font>=== |
Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente). | Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente). | ||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
Línea 4335: | Línea 4426: | ||
|Documento XML (ApplicationResponse) codificado en Base64 | |Documento XML (ApplicationResponse) codificado en Base64 | ||
|} | |} | ||
+ | {{clear}} | ||
+ | ===<font color="blue">Método EstadoCertificado</font>=== | ||
+ | Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento. | ||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="2"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Suministrado por The Factory HKA Colombia | ||
+ | |- | ||
+ | |tokenPassword | ||
+ | |} | ||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |String | ||
+ | |active | ||
+ | |Indica el Estatus actual en el que se encuentra el certificado digital | ||
+ | |- | ||
+ | |String | ||
+ | |dateFrom | ||
+ | |Indica la fecha desde la cual se encuentra activo el certificado digital | ||
+ | |- | ||
+ | |String | ||
+ | |dateTo | ||
+ | |Indica la fecha de vencimiento del certificado digital. | ||
+ | |- | ||
+ | |Int | ||
+ | |identification | ||
+ | |Muestra el numero de identificación del contribuyente al que pertenece el certificado | ||
+ | |- | ||
+ | |Int | ||
+ | |codigo | ||
+ | |Indica el Estado de la operación retornado por el servicio | ||
+ | |- | ||
+ | |String | ||
+ | |mensaje | ||
+ | |Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital. | ||
+ | |} | ||
+ | {{clear}} | ||
+ | |||
+ | <font color="red">'''@IMPORTANTE:'''</font> El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service. | ||
+ | |||
+ | :Para mayor información pude visitar la siguiente sección: | ||
+ | '''[[Tips Urls de Emisión| Tips Urls de Emisión]]''' | ||
{{clear}} | {{clear}} |
Revisión actual del 16:54 31 ago 2023
Sumario
- 1 Método Servicio Emisión Web Soap
- 1.1 Método Enviar
- 1.1.1 Class.FacturaGeneral
- 1.1.2 Class.Anticipos
- 1.1.3 Class.Autorizado
- 1.1.4 Class.CargosDescuentos
- 1.1.5 Class.Cliente
- 1.1.6 Class.CondicionPago
- 1.1.7 Class.Coordenadas
- 1.1.8 Class.DatosTransportistas
- 1.1.9 Class.Destinatario
- 1.1.10 Class.DetalleDeFactura
- 1.1.11 Class.Direccion
- 1.1.12 Class.DocumentoReferencia
- 1.1.13 Class.DocumentoReferenciado
- 1.1.14 Class.EntregaMercancia
- 1.1.15 Class.Extras
- 1.1.16 Class.Extensible
- 1.1.17 Class.FacturaImpuestos
- 1.1.18 Class.ImpuestosTotales
- 1.1.19 Class.InformacionLegalCliente
- 1.1.20 Class.LineaInformacionAdicional
- 1.1.21 Class.MediosDePago
- 1.1.22 Class.Obligaciones
- 1.1.23 Class.OrdenDeCompra
- 1.1.24 Class.sectorSalud
- 1.1.25 Class.Beneficiario
- 1.1.26 Class.DatosPacientesSalud
- 1.1.27 Class.GeneralSalud
- 1.1.28 Class.TasaDeCambio
- 1.1.29 Class.TasaDeCambioAlternativa
- 1.1.30 Class.TerminosEntrega
- 1.1.31 Class.Tributos
- 1.2 Método EstadoDocumento
- 1.3 Método EnvioCorreo
- 1.4 Método DescargaPDF
- 1.5 Método DescargaXML
- 1.6 Método FoliosRestantes
- 1.7 Método CargarCertificado
- 1.8 Método DescargarEventoXML
- 1.9 Método GenerarContenedor
- 1.10 Método GenerarEvento
- 1.11 Método EstadoCertificado
- 1.1 Método Enviar
Método Servicio Emisión Web Soap
Los parámetros a incorporar en los métodos de este Web Service deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:
Formato | Descripción |
---|---|
A | Carácter alfabético |
N | Carácter numérico |
AN | Carácter alfanumérico |
A|3 | 3 caracteres alfabéticos (longitud fija) |
N|3 | 3 caracteres numéricos (longitud fija) |
AN|3 | 3 caracteres alfanuméricos (longitud fija) |
A|..3 | Hasta 3 caracteres alfabéticos (longitud variable) |
N|..3 | Hasta 3 caracteres numéricos (longitud variable) |
AN|..3 | Hasta 3 caracteres alfanuméricos (longitud variable) |
N|2..6 | Entre 2 y 6 caracteres numéricos (longitud variable) |
INT32 | Entero. (Valor Máximo: 2,147,483,647) |
Obligatorio | Descripción |
---|---|
SI | Si es obligatorio para la DIAN |
NO | No es obligatorio para la DIAN |
C/C | Es requerido cuando corresponda (o bajo cierta condición por el modelo de negocio del cliente) |
Método Enviar
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por el proveedor tecnológico |
tokenPassword | ||
FacturaGeneral | factura | Ver el detalle del Objeto Factura más abajo |
String | adjuntos |
Posibles valores:
|
@IMPORTANTE: En caso de enviarse en el parámetro adjuntos el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método CargarAdjuntos (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo Destinatario.email del cliente es requerido y el campo notificar debe estar en “SI”.
ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).
A continuación, se expone el diagrama del objeto factura para el modelo de facturación con validación previa, donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:
- En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
- En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
- En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
Diagrama Class.FacturaGeneral con Class.Cliente
Diagrama Class.FacturaGeneral con Class.CondicionPago
Diagrama Class.FacturaGeneral con Class.FacturaDetalle
Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado
Diagrama Class.FacturaGeneral Class.EntregaMercancia
Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional
Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega
Class.FacturaGeneral
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
anticipos | Array <Anticipos> | - | NO |
|
autorizado | Autorizado | - | NO |
|
cantidadDecimales | String | N|1 | SI |
|
cargosDescuentos | Array <CargosDescuentos> | - | NO |
|
cliente | Cliente | - | SI |
|
condicionPago | Array <CondicionPago> | - | NO |
|
consecutivoDocumento | String | AN..14 | SI |
|
detalleDeFactura | Array <FacturaDetalle> | - | SI |
|
documentosReferenciados | Array <DocumentoReferenciado> | - | C/C |
|
entregaMercancia | Entrega | - | NO |
|
extras | Array <Extras> | - | NO |
|
fechaEmision | String | AN|19 | SI |
|
fechaFinPeriodoFacturacion | String | AN|19 | NO |
|
fechaInicioPeriodoFacturacion | String | AN|19 | NO |
|
fechaPagoImpuestos | String | AN|19 | NO |
|
fechaVencimiento | String | AN|10 | NO |
|
impuestosGenerales | Array <FacturaImpuestos> | - | SI |
|
impuestosTotales | Array <ImpuestosTotales> | - | SI |
|
informacionAdicional | Array <String> | AN|...10000 | NO |
|
mediosDePago | Array <MediosDePago> | - | SI |
|
moneda | String | AN|3 | SI |
|
ordenDeCompra | Array <OrdenDeCompra> | - | NO |
|
rangoNumeracion | String | AN|20 | SI |
|
redondeoAplicado | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
sectorSalud | sectorSalud | - | C/C |
|
tasaDeCambio | TasaDeCambio | - | C/C |
|
tasaDeCambioAlternativa | TasaDeCambioAlternativa | - | NO |
|
terminosEntrega | TerminosEntrega | - | C/C |
|
tipoDocumento | String | AN|2 | SI |
|
tipoSector | String | N|| | SI |
|
tipoOperacion | String | AN|..4 | SI |
|
totalAnticipos | String | Ent: N|..15
Dec: N|0..6 |
NO |
|
totalBaseImponible | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
totalBrutoConImpuesto | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
totalCargosAplicados | String | Ent: N|..15
Dec: N|0..6 |
NO |
|
totalDescuentos | String | Ent: N|..15
Dec: N|0..6 |
NO |
|
totalMonto | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
totalProductos | String | AN|..5 | SI |
|
totalSinImpuestos | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
Class.Anticipos
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extras | Array <Extensible> | - | NO |
|
fechaDeRecibido | String | AN|10 | SI |
|
fechadePago | String | AN|10 | NO |
|
horaDePago | String | AN|8 | NO |
|
id | String | A|..150 | SI |
|
instrucciones | String | AN|15..500 | SI |
|
montoPagado | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
Class.Autorizado
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
direccion | Direccion | - | NO |
|
String | AN|..50 | NO |
| |
extras | Array <Extensible> | - | NO |
|
nombreComercial | String | AN|..50 | NO |
|
nombreContacto | String | AN|..50 | NO |
|
nota | String | AN|..50 | NO |
|
numeroDocumento | String | AN|..12 | SI |
|
numeroDocumentoDV | String | AN|..2 | C/C |
|
razonSocial | String | AN|..50 | NO |
|
telefax | String | AN|..50 | NO |
|
telefono | String | AN|..50 | NO |
|
tipoIdentificacion | String | AN|..2 | SI |
|
Class.CargosDescuentos
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigo | String | AN|2 | C/C |
|
descripcion | String | AN|10..5000 | SI |
|
extras | Array <Extensible> | - | NO |
|
indicador | String | N|1 | SI |
|
monto | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
montoBase | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
porcentaje | String | Ent: N|..6
Dec: N|2 |
SI |
|
secuencia | String | N|..3 | SI |
|
Class.Cliente
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
actividadEconomicaCIIU | String | AN|…4 | NO |
|
apellido | String | AN|…50 | NO |
|
destinatario | Array <Destinatario> | - | C/C |
|
detallesTributarios | Array <Tributos> | - | SI |
|
direccionCliente | Direccion | - | C/C |
|
direccionFiscal | Direccion | - | C/C |
|
String | AN|..50 | C/C |
| |
extras | Array <Extensible> | - | NO |
|
informacionLegalCliente | InformacionLegalCliente | - | C/C |
|
nombreComercial | String | AN|5..450 | C/C |
|
nombreContacto | String | AN|5..450 | NO |
|
nombreRazonSocial | String | AN|5..450 | SI |
|
nota | String | AN|..450 | NO |
|
notificar | String | AN|2 | SI |
|
numeroDocumento | String | AN|..12 | SI |
|
numeroIdentificacionDV | String | AN|..2 | C/C |
|
responsabilidadesRut | Array <Obligaciones> | - | SI |
|
segundoNombre | String | AN|..50 | NO |
|
telefax | String | N|..20 | NO |
|
telefono | String | AN|..20 | NO |
|
tipoIdentificacion | String | N|2 | SI |
|
tipoPersona | String | N|1 | SI |
|
Class.CondicionPago
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoEvento | String | AN|..3 | NO |
|
comentario | String | AN|..50 | NO |
|
duracionPeriodo | String | AN|..2 | NO |
|
duracionPeriodoMedida | String | AN|..10 | NO |
|
extras | Array <Extensible> | - | NO |
|
fechaVencimiento | String | AN|..10 | SI |
|
identificador | String | AN|..2 | NO |
|
medioPagoAsociado | String | AN|..2 | NO |
|
monto | String | Ent: N|..15 | SI |
|
montoMulta | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
montoPenalidad | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
periodoDesde | String | AN|..10 | NO |
|
periodoHasta | String | AN|..10 | NO |
|
porcentajeDescuento | String | Ent: N|..6
Dec: N|2 |
NO |
|
porcentajePago | String | Ent: N|..6
Dec: N|2 |
SI |
|
referenciaAnticipo | String | AN|..20 | NO |
|
Class.Coordenadas
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
gradosLatitud | String | Por Definir | NO |
|
gradosLongitud | String | Por Definir | NO |
|
minutosLatitud | String | N|…5|2.2 | NO |
|
minutosLongitud | String | N|…5|2.2 | NO |
|
orientacionLatitud | String | AN|1 | NO |
|
orientacionLongitud | String | AN|1 | NO |
|
Class.DatosTransportistas
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
detallesTributarios | Tributos | - | NO |
|
direccionResponsableEntrega | Direccion | - | NO |
|
String | AN|..50 | NO |
| |
extras | Array <Extensible> | - | NO |
|
indicadordeAtencion | String | AN|..50 | NO |
|
indicadordeCuidado | String | AN|..50 | NO |
|
nombreContacto | String | AN|..50 | NO |
|
nombreResponsableEntrega | String | AN|..50 | NO |
|
nota | String | - | NO |
|
numeroIdentificacion | String | AN|…12 | NO |
|
numeroIdentificacionDV | String | N|..2 | NO |
|
numeroMatriculaMercantil | String | AN|..20 | NO |
|
prefijoFacturacion | String | AN|..20 | NO |
|
responsabilidadesRut | Array <Obligaciones> | - | NO |
|
telefax | String | AN|..20 | NO |
|
telefono | String | AN|..20 | NO |
|
tipoIdentificacion | String | N|2 | NO |
|
transportadorDireccion | Direccion | - | NO |
|
transportadorNombre | String | AN|..50 | NO |
|
transportadorNumeroDocumento | String | AN|..12 | NO |
|
transportadorNumeroDocumentoDV | String | AN|..2 | NO |
|
transportadorTipoIdentificacion | String | N|2 | NO |
|
Class.Destinatario
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
canalDeEntrega | String | - | SI |
|
Array <String> | - | C/C |
| |
extras | Array <Extensible> | - | NO |
|
fechaProgramada | String | AN|19 | NO |
|
mensajeProgramado | String | - | NO |
|
nitProveedorReceptor | String | N|..12 | C/C |
|
telefono | String | AN|..20 | C/C |
|
Class.DetalleDeFactura
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidadPorEmpaque | String | N|..3 | NO |
|
cantidadReal | String | N|..6 | SI |
|
cantidadRealUnidadMedida | String | AN|..6 | SI |
|
cantidadUnidades | String | N|..6 | SI |
|
cargosDescuentos | Array <CargosDescuentos> | - | C/C |
|
codigoFabricante | String | - | NO |
|
codigoIdentificadorPais | String | A|2 | NO |
|
codigoProducto | String | AN|..50 | SI |
|
codigoTipoPrecio | String | AN|..3 | C/C |
|
descripcion | String | AN|..300 | C/C |
|
descripcion2 | String | AN|..300 | C/C |
|
descripcion3 | String | AN|..300 | C/C |
|
descripcionTecnica | String | AN|..300 | NO |
|
documentosReferenciados | Array <DocumentoReferenciado> | - | NO |
|
estandarCodigo | String | AN | C/C |
|
estandarCodigoID | String | AN | NO |
|
estandarCodigoIdentificador | String | AN | NO |
|
estandarCodigoNombre | String | AN | NO |
|
estandarCodigoProducto | String | AN | C/C |
|
estandarOrganizacion | String | - | NO |
|
estandarSubCodigoProducto | String | - | NO |
|
extras | Array <Extensible> | - | NO |
|
impuestosDetalles | Array <FacturaImpuestos > | - | SI |
|
impuestosTotales | Array <ImpuestosTotales> | - | SI |
|
informacionAdicional | Array <LineaInformacionAdicional> | - | NO |
|
mandatorioNumeroIdentificacion | String | N|..12 | C/C |
|
mandatorioNumeroIdentificacionDV | String | N|..2 | C/C |
|
mandatorioTipoIdentificacion | String | N|2 | C/C |
|
marca | String | AN|..100 | C/C |
|
modelo | String | AN|..100 | C/C |
|
muestraGratis | String | N|1 | C/C |
|
nombreFabricante | String | AN|..100 | NO |
|
nota | String | AN|20..5000 | C/C |
|
precioReferencia | String | Ent: N|..15
Dec: N|0..6 |
C/C |
|
precioTotal | String | Ent: N|..15
Dec: N|0..6 |
C/C |
|
precioTotalSinImpuestos | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
precioVentaUnitario | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
secuencia | String | AN|..4 | SI |
|
seriales | String | AN|..500 | NO |
|
subCodigoFabricante | String | AN|..50 | NO |
|
subCodigoProducto | String | AN|..50 | NO |
|
tipoAIU | String | AN|..50 | NO |
|
unidadMedida | String | AN|..3 | SI |
|
Class.Direccion
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
aCuidadoDe | String | AN|..50 | NO |
|
aLaAtenciónDe | String | AN|..50 | NO |
|
bloque | String | AN|..50 | NO |
|
buzon | String | AN|..50 | NO |
|
calle | String | AN|..50 | NO |
|
calleAdicional | String | AN|..50 | NO |
|
ciudad | String | AN|…50 | SI |
|
codigoDepartamento | String | AN|…5 | SI |
|
correccionHusoHorario | String | AN|6 | NO |
|
departamento | String | AN|…50 | SI |
|
departamentoOrg | String | AN|..50 | NO |
|
direccion | String | AN|…100 | SI |
|
distrito | String | AN|..50 | NO |
|
extras | Array <Extensible> | - | NO |
|
habitacion | String | AN|..50 | NO |
|
lenguaje | String | A|2 ISO 639-1 | SI |
|
localizacion | Array <Coordenadas> | AN|..50 | NO |
|
municipio | String | AN|..50 | SI |
|
nombreEdificio | String | AN|..50 | NO |
|
numeroEdificio | String | AN|..50 | NO |
|
numeroParcela | String | AN|..50 | NO |
|
pais | String | A|2 | SI |
|
piso | String | AN|..50 | NO |
|
region | String | AN|..50 | NO |
|
subDivision | String | AN|..40 | NO |
|
ubicación | String | AN|..50 | NO |
|
zonaPostal | String | AN|..10 | NO |
|
Class.DocumentoReferencia
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoEstatusDocumento | String | - | C/C | |
codigoInterno | String | N|1 | SI |
|
cufeDocReferenciado | String | AN|..90 | C/C |
|
descripcion | Array <String> | AN|20..5000 | C/C |
|
extras | Array <Extensible> | - | NO |
|
fecha | String | AN|10 | C/C |
|
fechaFinValidez | String | AN|10 | NO |
|
fechaInicioValidez | String | AN|10 | NO |
|
numeroDocumento | String | AN..20 | SI |
|
tipoCUFE | String | AN|..11 | C/C |
|
tipoDocumento | String | AN|..50 | NO |
|
tipoDocumentoCodigo | String | AN|2 | C/C |
|
@IMPORTANTE:
- Para referenciar facturas de venta al emitir una NC o ND, se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
- Objeto 1: indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
- Objeto 2: si el tipoOperacion es igual a 20 (para NC) ó 30 (para ND) y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
- Al transmitir una Factura de Contingencia, se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
- Para referenciar Documentos de Despacho (codigoInterno = ’2’) o Documentos de Recepción (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.
|}
Class.DocumentoReferenciado
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoEstatusDocumento | String | - | C/C | |
codigoInterno | String | N|1 | SI |
|
cufeDocReferenciado | String | AN|..90 | C/C |
|
descripcion | Array <String> | AN|20..5000 | C/C |
|
extras | Array <Extensible> | - | NO |
|
fecha | String | AN|10 | C/C |
|
fechaFinValidez | String | AN|10 | NO |
|
fechaInicioValidez | String | AN|10 | NO |
|
numeroDocumento | String | AN..20 | SI |
|
tipoCUFE | String | AN|..11 | C/C |
|
tipoDocumento | String | AN|..50 | NO |
|
tipoDocumentoCodigo | String | AN|2 | C/C |
|
@IMPORTANTE: # Para referenciar facturas de venta al emitir una NC o ND, se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
- Objeto 1: indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
- Objeto 2: si el tipoOperacion es igual a 20 (para NC) ó 30 (para ND) y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
- Al transmitir una Factura de Contingencia, se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
- Para referenciar Documentos de Despacho (codigoInterno = ’2’) o Documentos de Recepción (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.
Class.EntregaMercancia
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
datosTransportistas | DatoTransportistas | - | NO |
|
direccionDespacho | Direccion | - | NO |
|
direccionEntrega | Direccion | - | NO |
|
extras | Array <Extensible> | - | NO |
|
fechaEfectivaSalida | String | AN|19 | NO |
|
fechaEstimada | String | AN|19 | NO |
|
fechaReal | String | AN|19 | NO |
|
fechaSolicitada | String | AN|19 | NO |
|
identificacionTransporte | String | AN|..20 | NO |
|
matriculaTransporte | String | AN|..20 | NO |
|
Class.Extras
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
controlInterno1 | String | AN|100 | C/C |
|
controlInterno2 | String | Depende del Campo | C/C |
|
nombre | String | Depende del Campo | SI |
|
String | N|1 | SI |
| |
valor | String | Depende del Campo | SI |
|
xml | String | N|1 | SI |
|
Class.Extensible
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
controlInterno1 | String | AN|100 | C/C |
|
controlInterno2 | String | Depende del Campo | C/C |
|
nombre | String | Depende del Campo | SI |
|
valor | String | Depende del Campo | SI |
|
Class.FacturaImpuestos
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
baseImponibleTOTALImp | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
codigoTOTALImp | String | AN|2 | SI |
|
controlInterno | String | N|1 | C/C |
|
extras | Array <Extensible> | - | NO |
|
porcentajeTOTALImp | String | Ent: N|..2
Dec: N|2* |
SI |
|
unidadMedida | String | AN|..5 | SI |
|
unidadMedidaTributo | String | Ent: N|..2
Dec: N|2 |
C/C |
|
valorTOTALImp | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
valorTributoUnidad | String | Ent: N|..15
Dec: N|0..6 |
C/C |
|
@IMPORTANTE: Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104.
Class.ImpuestosTotales
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoTOTALImp | String | AN|2 | SI |
|
extras | Array <Extensible> | - | NO |
|
montoTotal | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
Class.InformacionLegalCliente
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoEstablecimiento | String | - | NO |
|
nombreRegistroRUT | String | AN|..450 | SI |
|
numeroIdentificacion | String | AN|..12 | SI |
|
numeroIdentificacionDV | String | N|..2 | C/C |
|
numeroMatriculaMercantil | String | N|9 | NO |
|
prefijoFacturacion | String | - | NO |
|
tipoIdentificacion | String | N|2 | SI |
|
Class.LineaInformacionAdicional
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cantidad | String | AN|..5 | NO |
|
codigo | String | AN|..5 | NO |
|
codigoInterno1 | String | - | NO |
|
codigoInterno2 | String | - | NO |
|
descripcion | String | AN|..450 | NO |
|
fechaFin | String | AN|10 | NO |
|
fechaInicio | String | AN|10 | NO |
|
nombre | String | AN|..50 | NO |
|
secuencia | String | AN|..3 | NO |
|
tipo | String | N|1 | NO |
|
valor | String | AN|..50 | NO |
|
Class.MediosDePago
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoBanco | String | AN|..20 | NO |
|
codigoCanalPago | String | AN|..20 | NO |
|
codigoReferencia | String | AN|..20 | NO |
|
extras | Array <Extensible> | - | NO |
|
fechaDeVencimiento | String | AN|19 | C/C |
|
medioPago | String | AN|..2 | SI |
|
metodoDePago | String | AN|..2 | SI |
|
nombreBanco | String | AN|..50 | NO |
|
numeroDeReferencia | String | AN|..200 | NO |
|
numeroDias | String | N|..3 | NO |
|
numeroTransferencia | String | AN|..20 | NO |
|
Class.Obligaciones
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
extras | Array <Extensible> | - | NO |
|
obligaciones | String | AN|7 | SI |
|
regimen | String | AN|2 | NO |
|
Class.OrdenDeCompra
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoCliente | String | AN|..20 | NO |
|
documentoReferencia | DocumentoReferencia | - | NO |
|
extras | Array <Extensible> | - | NO |
|
fecha | String | AN|10 | NO |
|
numeroOrden | String | AN|..20 | SI |
|
numeroPedido | String | AN|..20 | C/C |
|
tipoCUFE | String | AN|..20 | NO |
|
tipoOrden | String | AN|..20 | NO |
|
uuid | String | AN|..90 | NO |
|
NOTA: Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con codigoInterno =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.
Class.sectorSalud
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
Beneficiario | Beneficiario | - | C/C |
|
extras | Array <Extras> | - | NO |
|
IdPersonalizacion | String | Por definir | C/C |
|
Pacientes | Array <DatosPacienteSalud> | - | C/C | Para el reporte de los campos de datos adicionales del Sector Salud
|
TipoEscenario | String | N|1 | SI |
|
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.
Class.Beneficiario
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
DireccionResidencia | Direccion | - | C/C |
|
TipoIdentificacion | Array <GeneralSalud> | - | C/C |
|
Class.DatosPacientesSalud
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
CamposGenerales | Array <GeneralSalud> | - | C/C |
|
TipoIdentificacion | Array <GeneralSalud> | - | C/C |
|
Class.GeneralSalud
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
nombre | String | ..2 | Si |
|
valor | String | Depende del campo | Si |
|
Importante: En el caso del campo rangoNumeracion, éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).
En el caso del campo consecutivoDocumento, este campo si depende de la modalidad de secuenciales configurados en el portal web.
- Si la modalidad asignada es “manual sin prefijo”, los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
- Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
- Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
- ...
- Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"
- Si la modalidad asignada es “manual con prefijo”, los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
- Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
- Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
- ...
- Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"
Class.TasaDeCambio
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
baseMonedaDestino | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
baseMonedaOrigen | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
extras | Array <Extensible> | - | NO |
|
fechaDeTasaDeCambio | String | AN|10 | SI |
|
indicadorDeTasa | String | - | NO |
|
monedaDestino | String | AN|3 | SI |
|
monedaOrigen | String | AN|3 | SI |
PATH: ../cbc:SourceCurrencyCode |
operadorCalculo | String | - | NO |
|
tasaDeCambio | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
Class.TasaDeCambioAlternativa
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
baseMonedaDestino | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
baseMonedaOrigen | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
extras | Array <Extensible> | - | NO |
|
fechaDeTasaDeCambio | String | AN|10 | SI |
|
indicadorDeTasa | String | - | NO |
|
monedaDestino | String | AN|3 | SI |
|
monedaOrigen | String | AN|3 | SI |
|
operadorCalculo | String | - | NO |
|
tasaDeCambio | String | Ent: N|..15
Dec: N|0..6 |
SI |
|
Class.TerminosEntrega
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
cargosDescuentos | Array <CargosDescuentos> | - | NO |
|
codigoCondicionEntrega | String | AN|3 | C/C |
|
costoTransporte | String | Por Definir | NO |
|
direccionEntrega | Class.Direccion | - | NO |
|
extras | Array <Extensible> | - | NO |
|
identificacion | String | AN|..12 | NO |
|
monto | String | Ent: N|..15
Dec: N|0..6 |
NO |
|
responsableEntrega | String | AN|..50 | NO |
|
Class.Tributos
Atributo | Tipo Dato | Formato | Requerido | Descripción |
---|---|---|---|---|
codigoImpuesto | String | AN|2 | SI |
|
extras | Array <Extensible> | - | NO |
|
- RESPONSE
- Parámetros a Recibir
Tipo | Identificación | Descripción |
---|---|---|
int | codigo | Indica el Estado de la operación retornado por el servicio, (Por definir catálogo) |
String | consecutivoDocumento | Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337” |
String | cufe | “Código Único de Factura Electrónica” correspondiente al documento consultado. |
Bool | esValidoDian | “true” Si es válido |
String | fechaAceptacionDIAN | Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS |
String | fechaRespuesta | Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS |
String | hash | Código de detección de errores |
String | mensaje | Este mensaje está asociado al código de respuesta, útil para identificación de errores |
Array | mensajesValidacion | Mensajes de validación en caso de notificación o rechazo |
String | nombre | Nombre definido por la DIAN |
String | qr | Concatenación cadena del código QR (elemento de control) |
Array | reglasNotificacionDIAN | Reglas de validación en caso de notificación |
Array | reglasValidacionDIAN | Reglas de validación en caso de rechazo |
String | resultado | Resultado del consumo del método: Procesado” ó “Error” |
String | tipoCufe | Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384” |
String | xml | Archivo XML (tipo AttachedDocument) codificado en Base64 |
Una vez realizado el envío exitoso de la factura electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método CargarAdjuntos) consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro adjuntos se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.
Método EstadoDocumento
Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword | ||
Documento | Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212 |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Bool | aceptacionFisica | Indica si el documento posee aceptación física (entregado físicamente): “true” o “false” |
String | acuseComentario | Comentario informado por el adquiriente al realizar el acuse |
String | acuseEstatus | 0: Acuse no realizado ; 1: Acuse realizado |
String | acuseResponsable | Email del responsable de realizar el acuse |
String | acuseRespuesta | 0: Respuesta no enviada ; 1: Respuesta enviada |
String | ambiente | Tipo de ambiente de generación del documento:
|
String | cadenaCodigoQR | Concatenación cadena del código QR (elemento de control) |
String | cadenaCufe | Concatenación cadena del código CUFE previo al cálculo por el algoritmo correspondiente del servicio |
int | Codigo | Indica el estado de la operación retornado por el servicio |
String | consecutivo | Consecutivo del Documento TFHKA/DIAN |
String | cufe | “Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio |
String | descripcionDocumento | Identificador del tipo de documento de referencia,
|
String | descripcionEstatusDocumento | Descripción correspondiente al estatusDocumento ante la DIAN: “Procesado Correctamente” |
String | entregaMetodoDIAN | Indica el método de Entrega a la DIAN
|
Bool | esValidoDIAN |
|
String | estatusDocumento | Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN (Por definir catálogo) |
Array <Evento> | eventos | Lista de eventos del Documento Electrónico |
String | fechaAceptacionDIAN | Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS |
String | fechaDocumento | Fecha en la que se generó el documento, en formato: AAAA-MM-DD |
Array <HistorialDeEntregas> | historialDeEntregas | Histórico de las entregas del documento |
String | mensaje | Este mensaje está asociado al codigo, útil para identificación de errores |
String | mensajeDocumento | Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción |
Bool | poseeAdjuntos | Indica si el documento posee adjuntos:
|
Bool | poseeRepresentacionGrafica | Indica si el documento posee representación gráfica:
|
Array <String> | reglasValidacionDIAN | Mensajes de validación por parte de la DIAN |
String | resultado | Resultado del consumo del método:
|
String | tipoCufe | Algoritmo utilizado para calcular CUFE:
|
String | tipoDocumento | Identificador del tipo de documento de referencia
|
String | trackID | Este elemento corresponde al TrackId del documento procesado |
Donde Class.Evento contiene la siguiente información:
Tipo | Identificador | Descripción |
---|---|---|
String | ambienteDIAN | Ambiente de generación en la DIAN:
|
String | codigo | Código el documento del Application Response (evento) |
String | comentario | Comentario del evento |
String | cufe | CUFE del documento electronico |
String | descripcionEvento | Descripción de uso/origen del evento |
String | emisorNumeroDocumento | Número de Identificación del Emisor |
String | emisorNumeroDocumentoDV | Dígito Verificador del Número de Documento del Emisor |
String | emisorRazonSocial | Razón Social del Emisor |
String | emisorTipoIdentificacion | Tipo de Identificación del Emisor |
Array <ExtrasEvento> | extras | Información extra correspondiente al evento |
String | fechaEmision | Fecha de Emisión del Application Response (evento) |
String | fechaRecepcion | Fecha de Recepción del Application Response (evento) |
String | hash | Hash del documento Application Response |
String | idPerfilDIAN | Perfil de la DIAN |
String | mensaje | Mensaje de descripción del ApplicationResponse |
String | nombreArchivoXML | Nombre del archivo XML |
String | nota | Contenido del campo Note del Application Response |
String | numeroDelEvento | Consecutivo del Application Response |
String | receptorNumeroDocumento | Número de Identificación del Receptor |
String | receptorNumeroDocumentoDV | Dígito Verificador del Número de Documento del Receptor |
String | receptorRazonSocial | Razón Social del Receptor |
String | receptorTipoIdentificacion | Tipo de Identificación del Receptor |
String | resultado | Resultado del consumo del método:
|
String | tipoCufe | Algoritmo utilizado para calcular CUDE del evento:
|
String | tipoEvento | Identificador del tipo de Evento:
|
String | versionUBL | Versión UBL del XML |
Y Class.ExtrasEvento contiene la siguiente información:
Tipo | Identificador | Descripción |
---|---|---|
String | codigoInterno1 | Etiqueta |
String | codigoInterno2 | Descripción Adicional |
String | nombre | Código del campo |
String | valor | Información Adicional |
Class.HistorialDeEntregas corresponderá a:
Tipo | Identificador | Descripción |
---|---|---|
String | LeidoEmailIPAddress | Dirección IP del computador en el cual se realizó el acuse del correo de notificación |
String | LeidoEstatus | Estatus del acuse del correo de notificación |
String | LeidoFecha | Fecha del acuse del correo de notificación |
String | canalDeEntrega | Canal de entrega del documento electrónico |
Array <String> | Email del receptor del documento electrónico | |
String | entregaEstatus | Estatus de la entrega:
|
String | entregaEstatusDescripcion | Descripción del Estatus de la entrega |
String | entregaFecha | Fecha de la Entrega del documento |
String | fechaProgramada | Fecha de la Entrega |
String | mensajePersonalizado | Mensaje personalizado para entrerga por Email, Whatsaap o Telegram |
String | nitProveedorReceptor | NIT del Proveedor Tecnológico receptor, en caso de entrega por Interoperabilidad |
String | recepcionEmailComentario | Comentario de Acuse de Recibo del Cliente |
String | recepcionEmailEstatus | Estatus de recepción del Correo Electrónico
|
String | recepcionEmailFecha | Fecha de recepción del Correo Electrónico |
String | recepcionEmailIPAddress | Dirección IP de recepción del Correo Electrónico |
String | telefono | Para entrega por Whatsapp/Telegram |
@Importante: La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
Método EnvioCorreo
Permite reenviar a una o varias direcciones de correos el documento indicado.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword | ||
Documento | Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”. Permite enviar múltiples destinatarios (máximo 5) separados por coma el carácter coma ‘,’ | |
correo | Correo electrónico al que se enviará el documento. Ejemplo nombre@empresa.com | |
adjuntos |
|
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
int | codigo | Indica el Estado de la operación retornado por el servicio |
String | mensaje | Este mensaje está asociado al código, útil para identificación de errores |
resultado | Resultado del consumo del método:
|
@Importante: Si durante la emisión del documento (método Enviar) el parámetro adjuntos se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método CargarAdjuntos del Servicio Adjuntos Web SOAP.
Método DescargaPDF
Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword | ||
documento | Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212” |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
int | codigo | Indica el Estado de la operación retornado por el servicio |
String | cufe | “Código Único de Factura Electrónica” correspondiente al documento consultado. |
String | documento | Documento PDF codificado en Base64 |
String | hash | Código de detección de errores |
String | mensaje | Este mensaje está asociado al codigo, útil para identificación de errores |
String | resultado | Resultado del consumo del método:
|
@Importante: Si durante la emisión del documento (método Enviar) el parámetro adjuntos se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
Método DescargaXML
Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword | ||
Documento | Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212 |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
int | codigo | Indica el Estado de la operación retornado por el servicio |
String | cufe | “Código Único de Factura Electrónica” correspondiente al documento consultado |
String | documento | Documento XML (Invoice, CreditNote ó DebitNote) codificado en Base64 |
String | hash | Código de detección de errores |
String | mensaje | Este mensaje está asociado al codigo, útil para identificación de errores |
String | resultado | Resultado del consumo del método:
|
Método FoliosRestantes
Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
int | codigo | Indica el Estado de la operación retornado por el servicio |
int | foliosRestantes | Cantidad de folios disponibles |
String | mensaje | Este mensaje está asociado al codigo, útil para identificación de errores |
String | resultado | Resultado del consumo del método:
|
Método CargarCertificado
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
Método DescargarEventoXML
Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword | ||
documentoEvento | Consecutivo del evento (ApplicationResponse) | |
Documento | Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212 |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
int | Código | Indica el Estado de la operación retornado por el servicio |
String | Cufe | CUFE del evento (ApplicationResponse) |
String | Documento | Documento XML (ApplicationResponse) codificado en Base64 |
String | fechaRespuesta | Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS |
String | Hash | Código de detección de errores |
String | Mensaje | Este mensaje está asociado al codigo, útil para identificación de errores. |
String | Resultado | Resultado del consumo del método:
|
String | tipoCufe | Algoritmo utilizado para calcular CUFE:
|
Método GenerarContenedor
Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword | ||
Documento | Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212 |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
int | Código | Indica el Estado de la operación retornado por el servicio |
String | Contenedor | Documento XML (AttachedDocument) codificado en Base64 |
String | Fecha | Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS |
String | Hash | Código de detección de errores |
String | Mensaje | Este mensaje está asociado al codigo, útil para identificación de errores. |
String | Resultado | Resultado del consumo del método:
|
Método GenerarEvento
Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword | ||
DatosEvento | datosEvento | Objeto con los datos del evento (ApplicationResponse) a generar |
Donde Class.DatosEvento contiene la siguiente información:
Tipo | Identificador | Descripción |
---|---|---|
String | codigoEvento | Indica el código del evento (Por definir catálogo) |
String | codigoInterno1 | Etiqueta |
String | codigoInterno2 | Descripción Adicional |
String | Comentario | Comentario o descripción del evento |
String | Documento | Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212” |
Array <ExtrasEvento> | Extras | Información adicional del evento |
Donde Class.ExtrasEvento contiene la siguiente información:
Tipo | Identificador | Descripción |
---|---|---|
String | codigoInterno1 | Etiqueta |
String | codigoInterno2 | Descripción Adicional |
String | Nombre Código | del campo |
String | valor | Información adicional |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
int | Código | Indica el Estado de la operación retornado por el servicio |
String | consecutivoDocumentoEvento | Consecutivo del evento (ApplicationResponse) |
String | Cufe | CUFE del evento (ApplicationResponse) |
String | fechaRespuesta | Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS |
String | Hash | Código de detección de errores |
String | Mensaje | Este mensaje está asociado al codigo, útil para identificación de errores. |
String | Resultado | Resultado del consumo del método:
|
String | tipoCufe | Algoritmo utilizado para calcular CUFE:
|
String | Xml | Documento XML (ApplicationResponse) codificado en Base64 |
Método EstadoCertificado
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción |
---|---|---|
String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
tokenPassword |
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
String | active | Indica el Estatus actual en el que se encuentra el certificado digital |
String | dateFrom | Indica la fecha desde la cual se encuentra activo el certificado digital |
String | dateTo | Indica la fecha de vencimiento del certificado digital. |
Int | identification | Muestra el numero de identificación del contribuyente al que pertenece el certificado |
Int | codigo | Indica el Estado de la operación retornado por el servicio |
String | mensaje | Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital. |
@IMPORTANTE: El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.
- Para mayor información pude visitar la siguiente sección:
Tips Urls de Emisión