La Factura T es un comprobante emitido por un responsable inscripto del sector de alojamiento a turistas extranjeros cuando las operaciones están sujetas al reintegro del Impuesto al Valor Agregado.
Comprobaciones:
La sesión es válida (si están activadas las sesiones). Implica que el usuario exista.
La empresa existe y pertenece al usuario.
El idCliente existe y pertenece a la empresa.
|
|
|
Nombre del campo | Requerimientos |
|
idEmpresa | Identificador de la Empresa en todo el sistema. Numérico entero. Obligatorio |
|
idCliente | Identificador del Cliente de la Empresa. Numérico entero. Obligatorio. |
|
idFactura | Identificador de la Factura para la Empresa con identificador idEmpresa. Numérico entero. Obligatorio en operaciones de lectura y edición. En operación de alta idFactura='' |
|
descripcion | Descripción genérica de la factura. Alfanumérico. Max 100 caracteres |
|
fechaFactura | Fecha de la Factura. Formato (d-m-A). Obligatorio en operaciones de Alta y Editar. |
|
fechaPago | Fecha de la Factura. Formato (d-m-A). Obligatorio en operaciones de Alta y Editar. |
|
idCondiciónPago | Ver valores admitidos de Condición de Pago en Apéndice. |
|
idEstadoAnterior | Estado anterior de la factura antes de ser editada. Requerido en lectura y edición. Los mismos valores de idEstadoFactura |
|
idEstadoFactura | Estado de la Factura. Valores admitidos en Apéndice |
|
idMoneda | 1 |
|
idTipoComprobante | Entero. Valores admitidos en Apéndice. Solo Alta.Requerido |
|
idTipoFactura | Valores admitidos en Apéndice.Requerido |
|
netoGravado | Total sobre el que se calcula el IVA. Numérico con decimales. Requerido |
|
netoNoGravado | Total que no lleva IVA. Requerido |
|
nroFactura1 | Sucursal.4 dígitos. Requerido |
|
nroFactura2 | Nro. de factura. 8 dígitos. Requerido. Salvo Factura Electrónica. |
|
labelfe | Enviar el valor "Factura Electrónica" en caso de ser tal |
|
orderId | Orden de Compra (Se usa con MELI) |
|
percepcionIVA | Numérico con decimales. Obligatorio |
|
percepcionIIBB | Numérico con decimales. Obligatorio |
|
ItemsFactura | Items de la factura en forma de Arreglo. Obligatorio. Ver detalle más adelante. |
|
ItemsCobro | Items de cobranza de factura en forma de arreglo. Obligatorio. Ver detalle más adelante. |
|
totalFactura | Total a cobrar de la factura. Numérico con decimales. Obligatorio |
|
totalIVA | Total de IVA de la factura. Suma de los IVAs de distintos porcentajes en caso de que hubiera. Numérico con decimales. Puede ser 0. |
|
valorCambio | 1 |
|
totalesiva | Tolates de IVA por alícuota en forma de Arreglo. Obligatorio. Ver detalle más adelante. |
|
codigoTurismo | Numérico entero. Obligatorio | 1 Servicio de hotelería - alojamiento sin desayuno 2 Servicio de hotelería - alojamiento con desayuno 3 Excedente |
emisorReceptor | Numérico entero. Obligatorio | 1 Alojamiento Directo a Turista No Residente 2 Alojamiento a Agencia de Viaje Residente 3 Alojamiento a Agencia de Viaje No Residente 4 Agencia de Viaje Residente a Agencia de Viaje No Residente 5 Agencia de Viaje Residente a Turista No Residente 6 Agencia de Viaje Residente a Agencia de Viaje Residente |
formaDePago | Numérico entero. Obligatorio | 1 Tarjeta de Crédito 2 Tarjeta de Débito 3 Transferencia Bancaria |
tipoDePago | Numérico entero. Obligatorio | 1 Caja de ahorro 2 Cuenta corriente 3 American Express 4 Visa 5 Mastercard 6 Credencial 7 Carta Franca 8 Cabal 9 Diners 10 Tarjeta Shopping 11 Tarjeta Naranja 12 Otra |
numeroDePago | Es el numero de cuenta o los 6 primeros dígitos de la tarjeta con la que se pago. Alfanumérico. Obligatorio |
|
swiftCode | Alfanumérico. Es obligatorio cuando la formaDePago es Transferencia Bancaria |
|
Arreglo ItemsFactura
idItem | Identificador único del ítem en el inventario. Sólo cuando se utiliza "Inventario". |
minimo | cantidad disponible mínima definida para el ítem en el inventario. Sólo cuando se utiliza "Inventario". |
tipoItem | P=producto S=Servicio. Sólo cuando se utiliza "Inventario". |
codigo | código alfanumérico definido para el ítem en el inventario. Sólo cuando se utiliza "Inventario". |
Descripcion | descripción del ítem |
ccosto1 | Nombre del Centro de costos 1. |
ccosto2 | Nombre del Centro de costos 2. |
almacen | nombre del almacén definido en el módulo de inventario. Sólo cuando se utiliza "Inventario". |
unidadMedida | Alfanumérico. Requerido |
Cantidad | Entero. Requerido |
ImporteUnitario | Numérico con decimales. Requerido |
porcDesc | Numérico con decimales. |
IVA | Numérico con decimales. Requerido |
idPlanCuenta | Nombre de la Cuenta como figura en el Plan de Cuentas de la Empresa.. Alfanumérico. Obligatorio. |
Comentario | Alfanumérico. Requerido |
Arreglo ItemsCobro
idMedioCobro | Ver tabla adjunta |
idPlanCuenta | Alfanumérico. Requerido |
Banco | Nombre del banco definido en modulo tesorería. Requerido |
nroCheque | Numérico . Requerido |
fechaValidez | Fecha formato "dd-mm-aaaa".Requerido |
importe | Entero |
VAD | Alfanumérico. Requerido |
idTabla |
|
idElemento |
|
idItem |
|
Arreglo de Totales de IVA por Alícuota
alicuotaIva | Alfanumérico. Porcentaje de alícuota debe corresponder con valor de instalación |
baseImpIva | Número con decimales. Suma de bases imponibles para esta alícuota en items de la factura |
importeIva | Número con decimales. Suma de importes de IVA para esta alícuota. |
Validaciones que deben pasar los datos antes de enviarlos
1) totalFactura = netoGravado+netoNoGravado+percepcionIVA+percepcionIIBB
2) La condición de iva del cliente debe ser Del Exterior tal como se ve en la captura desde la plataforma.
Módulo Clientes> Gestion Cliente> Seleccionar el cliente> Información General
Ejemplo de operaciones alta Factura Venta Contado T
{
"auth": {
"usuario":"xxxxxx@xxxxx.com", //mail DEV//
"password": "369d552d2e82735664efe791510443f6" //CONTRASEÑA HASH//
},
"service": {
"provision": "FacturaVenta",
"operacion": "alta_facturaventa"
},
"parameters": {
"sesion": {
"usuario": "xxxxxx@xxxxx.com", //mail USUARIO DADO DE ALTA EN PLATAFORMA//
"claveSesion": "694b3df38683e3507708fa1a8f889a41" //CLAVE SESION RESULTADO DEL INICIO DE SESION EN EL AMBIENTE//
},
"descripcion": "Prueba factura T",
"fechaFactura": "05-02-2025",
"idCondicionPago": "Contado",
"fechaPago": "",
"idCliente": "11530562",
"idEmpresa": "86723",
"idEstadoAnterior": "",
"idEstadoFactura": "Cobrada",
"idFactura": "",
"idMoneda": "0",
"idTipoComprobante": "8",
"idTipoFactura": "T",
"idUsuario": "",
"labelfe": "Factura Electrónica",
"netoGravado": 1000,
"netoNoGravado": 0,
"nroFactura1": "0002",
"nroFactura2": "00000000",
"percepcionIIBB": 0,
"percepcionIVA": 0,
"itemsFactura": [
{
"idItem": "",
"minimo": null,
"tipoItem": "P",
"codigo": "00001",
"Descripcion": "Producto A",
"ccosto1": "",
"ccosto2": "",
"almacen": "",
"unidadMedida": "UND",
"Cantidad": 1,
"ImporteUnitario": 1000,
"porcDesc": 0,
"IVA": "21",
"subtotal": 1000,
"idPlanCuenta": "Ventas", //NOMBRE DE LA CUENTA CONTABLE DE INGRESO//
"Comentario": null
}
],
"ItemsCobro": [
{
"idMedioCobro": "Efectivo",
"idPlanCuenta": "CAJA en $", //NOMBRE DE LA CAJA DE TESORERÍA//
"Banco": "",
"nroCheque": "",
"fechaValidez": "",
"importe": 1000,
"VAD": "S",
"Conciliado": "",
"idTabla": 0,
"idElemento": 0,
"idItem": 0
}
],
"tipoFactura": "Contado",
"totalFactura": 1000,
"totalIVA": 210,
"totalpagadofactura": 1000,
"valorCambio": "1",
"totalesiva": [
{
"alicuotaIva": "21",
"importeIva": 210,
"baseImpIva": 1000
}
],
"price_list_id": "",
"codigoTurismo": 1,
"emisorReceptor": 1,
"formaDePago": 1,
"tipoDePago": 1,
"numeroDePago": "455677",
"swiftCode": ""
}
}
Resultado cuando se emite la FC T
{
"service": {
"provision": "FacturaVenta",
"operacion": "alta_facturaventa",
"version": "1_0_0_0",
"response_date": "2025-02-05 09:52:53"
},
"result": {
"estado": 0,
"mensaje": "La operación se realizó correctamente"
},
"response": {
"success": true,
"isPending": false,
"message": "El alta se realizó con éxito.",
"cae": 75063221470717,
"UrlFacturaPdf": "https://staging.colppy.com/resources/Provisiones/ColppyCommon/GenerarFactura.php",
"idfactura": "40930962",
"fechaFactura": "2025-02-05",
"nroFactura": "0002-00000030"
}
}
El comprobante solo se podra visualizar y imprimir desde la plataforma
Artículos relacionados
Por cualquier duda o consulta podés ponerte en contacto con nosotros vía e-mail a: soporte@colppy.com
¡Nuestro equipo está listo para ayudarte!