ListadoComprobantes

Los campos obligatorios están resaltados en negrita.
Descripción

Devuelve un listado de los comprobantes de la empresa relacionada al usuario que realiza la consulta. Los resultados serán devueltos en páginas de 50 registros cada una. Para obtener el listado completo se deberán realizar múltiples llamadas, tantas como páginas tenga la consulta.

Funcionalidad interna
  • Si el Filtro de búsqueda IdComprobante tiene valor, el resto de los campos del filtro no tienen incidencia, o sea tiene prioridad por sobre el resto de los filtros.
  • Si el IdComprobante buscado no es de la empresa ingresada por parámetro, el método ListadoComprobantes devuelve como respuesta Cero comprobantes encontrados.
Autenticación

Dentro del objeto “request” se encuentra el objeto “Autenticacion” el cual contiene propiedades para el usuario, contraseña y empresa.

La validación del usuario se comprueba controlando la existencia del mismo, la contraseña utilizada y la coincidencia de la empresa reportada contra la empresa en la que figura el usuario en la base de datos de Facturante.com.

Validaciones
  • Rango de fechas: fecha desde debe ser menor o igual a fecha hasta.
Nombre Campo Tipo Propósito
Parámetros de entrada
Autenticacion
Usuario nvarchar(400) Nombre del usuario
Hash varchar(50) Password
Empresa Int Identificador de la empresa a la que pertenece el usuario (Es brindado por LinkSide)
Filtros de Busqueda
FechaDesde Datetime Fecha de inicio del período a obtener
FechaHasta Datetime Fecha de fin del período a obtener
CUIT nvarchar(13) Cuit del emisor Sin guiones
IdComprobante int Identificador univoco del comprobante.
TipoComprobante nvarchar(3) Valores Posibles:
  • FA: FACTURA A
  • FA SUJ RET: OPERACIÓN SUJETA A RETENCIÓN
  • NCA: NOTA DE CREDITO A
  • NDA: NOTA DE DEBITO A
  • RA: RECIBO A
  • FB: FACTURA B
  • FB8001: FACTURA B a RI con Informe 8001
  • NCB: NOTA DE CREDITO B
  • NCB8001: NOTA DE CREDITO B a RI con Informe 8001
  • NDB: NOTA DE DEBITO B
  • RB: RECIBO B
  • FC: FACTURA C
  • NCC: NOTA DE CREDITO C
  • NDC: NOTA DE DEBITO C
  • RC: RECIBO C
  • FM: FACTURA M
  • NCM: NOTA DE CREDITO M
  • NDM: NOTA DE DEBITO M
  • RM: RECIBO M
  • PF: PROFORMA
NroPagina int Página solicitada. Default = 1.
Parámetros de salida
Estado Int Ver Respuestas
Mensaje varchar(1000) Mensaje que describe el resultado de la operación. Tanto para casos exitosos como para fallidos.
Respuestas
Listado de Comprobantes (TAG: Comprobante)
IdComprobante int Identificador unívoco del comprobante.
Prefijo nvarchar(4) Prefijo del comprobante (indica número de punto de venta)
Numero int Numero asignado por AFIP para ese comprobante
FechaHora datetime Fecha y hora de emisión del comprobante
CodigoBarrasCAI varchar(40) Código de barras representativo del Código de Autorización de Impresión (C.A.I.) implementado mediante "Código Entrelazado 2 de 5 ( Interleaved 2 of 5 ITF)".
URLPDF varchar(400) url del comprobante legal generado (PDF).
URLQRFiscal varchar(400) Url para generar el QR de AFIP según la normativa
CondicionVenta Int Valores arrojados:
  • 1= Contado
  • 2= Cuenta Corriente
  • 3= Tarjeta de Debito
  • 4= Tarjeta de Credito
  • 5= Cheque
  • 6= Ticket
  • 7= Otro
  • 8= MercadoPago
  • 9= Cobro Digital
  • 10= DineroMail
  • 11= Decidir
  • 12= Todo Pago
Legalmente son estos dos valores posibles.
EstadoComprobante nvarchar(50) Valores Arrojados:
  • 8: ESPERANDO CAE: indica que el comprobante está esperando para ser validado en AFIP. (Estado temporal)
  • 7: COMUNICACIÓN CON AFIP: Se está realizando la comunicación con el WS de AFIP para obtener el CAE. (Estado temporal)
  • 9: TIMEOUT AFIP: AFIP no respondió a tiempo la solicitud y se está resolviendo la situación. (Estado temporal)
  • 3: SIN ENVIO: indica que el comprobante fue generado con éxito y enviado, pero no ha llegado al destinatario. Puede que el email sea incorrecto, que la casilla destino no esté disponible o que esté llena. Se debe reenviar NO emitir nuevamente. (Estado Final)
  • 2: ENVIANDO: el comprobante ya obtuvo el CAE y está siendo enviado al cliente. (Estado temporal)
  • 4: PROCESADO: se realizó el envío al cliente con éxito y está esperando que el cliente lo abra. (Estado Final)
  • 6: ERROR EN COMPROBANTE: indica que el comprobante NO fue validado por AFIP. De modo que deberá evaluar el error para rehacer el comprobante salvando el mismo. (Estado Final)
  • 10: ESPERANDO RESPUESTA AFIP: indica que ya se solicitó la validación al WS de AFIP y se está esperando la respuesta. (Estado temporal)
EstadoConfirmado int Valores Arrojados:
  • 1: ACEPTADO: El servidor SMTP aceptó el envío del e-mail.
  • 2: RECHAZADO: El servidor SMTP rechazó el envío (por ejemplo porque la casilla de destino está llena o está mal formado el e-mail de destino).
  • 3: PENDIENTE: El e-mail está esperando a ser enviado.
  • 4: ENVIANDO: Se está enviando el e-mail.
  • 5: LEIDO: El e-mail fue leído por el destinatario.
FechaHoraCAE datetime Fecha y hora de otorgamiento del CAE
Bienes Bit Valores Arrojados:
  • 1: Bienes
  • 2: Servicios
  • 3: Productos y Servicios.
FechaServDesde datetime Fecha de inicio del periodo del servicio facturado.
FechaServHasta datetime Fecha de fin del periodo del servicio facturado.
FechaVtoPago datetime Fecha de vencimiento del pago
FechaVencimientoCae datetime Fecha de vencimiento del CAE(por defecto el CAE tiene una validez de 10 días para poner a disposición la factura)
CAE numeric(14,0) Codigo de autorización electrónica brindado por AFIP
MensajeAFIP Varchar(1000) Response de respuesta de AFIP ante la solicitud de CAE para ese comprobante
CodigoPagoElectronico nvarchar(50)  
IVA1 numeric(18,2) Importe total de IVA correspondiente a la alícuota del 10,5% (no es a nivel ítem)
IVA2 numeric(18,2) Importe total de IVA correspondiente a la alícuota del 21% (no es a nivel ítem)
IVA3 numeric(18,2) Importe total de IVA correspondiente a la alícuota del 27% (no es a nivel ítem)
IVA4 numeric(18,2) Importe total de IVA correspondiente a la alícuota del 2,5% (no es a nivel ítem)
IVA5 numeric(18,2) Importe total de IVA correspondiente a la alícuota del 5% (no es a nivel ítem)
ImporteImpuestosInternos money Importe correspondiente a impuestos internos aplicados
ImportePercepcionesMunic money Importe correspondiente a impuestos municipales aplicados
Moneda int Código de Moneda correspondiente.
Valores Posibles:
  • 2: PESOS Argentinos
  • 3: DOLAR Estadounidense
TipoDeCambio numeric(18,3) Factor de conversión a la moneda seleccionada. Para PESOS Arg = 1
PercepcionIIBB numeric(18,3) Importe Total correspondiente al % aplicado en concepto de percepción de ARBA al cliente - SOLO Si la empresa emisora es Agente de Retención de ARBA. Por defecto = 0
PercepcionIVA numeric(18,3) Total correspondiente al % aplicado en concepto de percepción de IVA al cliente - SOLO Si la empresa emisora es Agente de Retención de IVA. Por defecto = 0
SubTotal money Subtotal del comprobante
SubTotalExcento numeric(18,3) Sumatoria de los totales exentos (rubros o articulos específicos determinados por AFIP. Ej: entradas de espectáculos)
SubtotalNoAlcanzado numeric(18,3) Sumatoria de los totales NO alcanzados(productos específicos determinados por AFIP)
TipoComprobante nvarchar(3) Tipo comprobante. Solo indica las siglas. Valores arrojados:
  • FA: FACTURA A
  • FA SUJ RET: OPERACIÓN SUJETA A RETENCIÓN
  • NCA: NOTA DE CREDITO A
  • NDA: NOTA DE DEBITO A
  • RA: RECIBO A
  • FB: FACTURA B
  • FB8001: FACTURA B a RI con Informe 8001
  • NCB: NOTA DE CREDITO B
  • NCB8001: NOTA DE CREDITO B a RI con Informe 8001
  • NDB: NOTA DE DEBITO B
  • RB: RECIBO B
  • FC: FACTURA C
  • NCC: NOTA DE CREDITO C
  • NDC: NOTA DE DEBITO C
  • RC: RECIBO C
  • FM: FACTURA M
  • NCM: NOTA DE CREDITO M
  • NDM: NOTA DE DEBITO M
  • RM: RECIBO M
  • PF: PROFORMA
TotalConDescuento numeric(18,3) Sumatoria de todos los descuentos realizados (no incluye bonificación sobre item)
TotalNeto numeric(18,3) Total Neto, sin impuestos ni percepciones.
Total numeric(18,3) Total del comprobante con impuestos y percepciones incluidas.
EnviarComprobante Boolean True: se envió el comprobante emitido por email.
IntentosEnvioMail Smallint Si es distinto de NULL, indica la cantidad de veces que se reintentó el envio en caso de error de envío de email
Observaciones varchar(max) Texto incroporado al pie del comprobante
OrdenCompra varchar(50) Campo informativo.
Remito varchar(50) Campo informativo.
ProvinciaPercepcion nvarchar(50) Nombre de la provincia donde se aplica la percepción
PaginaActual int Número de página actual.
TotalComprobantes Int Cantidad total de comprobantes incluidos según el criterio de búsqueda recibido por parámetro.
TotalPaginas int Cantidad total de páginas resultantes a partir del criterio de búsqueda recibido por parámetro.
Cliente
RazonSocial varchar(500) Nombre de la persona física o jurídica del cliente, receptor del comprobante
CodigoPostal Nchar(10) Del cliente
CondicionPago nvarchar(50) Valores Posibles:
  • 1= Contado
  • 2= Cuenta Corriente
  • 3= Tarjeta de Debito
  • 4= Tarjeta de Credito
  • 5= Cheque
  • 6= Ticket
  • 7= Otro
  • 8= MercadoPago
  • 9= Cobro Digital
  • 10= DineroMail
  • 11= Decidir
  • 12= Todo Pago
Contacto nvarchar(2000) Nombre de la persona contacto
DireccionFiscal nvarchar(250) Dirección fiscal
EnviarComprobante boolean True: por defecto se envía el comprobante por email al cliente
MailContacto nvarchar(150) Dirección de mail de Contacto
MailFacturacion nvarchar(150) Dirección de mail de Facturación
TipoDocumento varchar(50) Valores Arrojados:
  • 1: DNI
  • 2: CDI
  • 3: LC
  • 4: LE
  • 5: Pasaporte
  • 6: CUIT
  • 7: CUIL
  • 9: CI Extranjera
  • 10: En trámite
  • 11: Acta nacimiento
  • 12: CI Bs. As. RNP
  • 13: Sin identificar/venta global diaria
  • 14: Certificado de Migración
  • 15: Usado por Anses para Padrón
NroDocumento Nvarchar(13)  
PercibeIIBB Boolean True: Si la empresa emisora es Agente de Retención de ARBA
PercibeIVA Boolean True: Si la empresa emisora es Agente de Retención de IVA
Telefono nvarchar(100) Teléfono de contacto
TratamientoImpositivo nvarchar(50) Código numérico correspondiente a la situación frente al IVA del cliente. Valores posibles:
  • 1: MONOTRIBUTISTA
  • 2: RESPONSABLE INSCRIPTO
  • 3: CONSUMIDOR FINAL
  • 4: IVA EXENTO
  • 5: IVA NO RESPONSABLE
  • 7: IVA NO ALCANZADO
IdentificadorExterno nvarchar(100) Identificador externo con el cual se identifica el cliente en otro sistema
Listado de Ítems
Cantidad numeric(18,2) Cantidad de unidades del producto
Detalle varchar(200) Descripción del producto
Codigo varchar(20) Código del producto
Bonificacion numeric(18,2) Porcentaje de bonificación al item en particular.
IVA numeric(18,2) Alícuota de IVA aplicada para ese ítem. Valores posibles:
  • 10,5
  • 21
  • 27
  • 2,5
  • 5
  • Exento
  • No gravado
PrecioUnitario numeric(18,2) Precio unitario del ítem (Neto en caso de RI, final en caso de Monotributista en tipo FB)
Total numeric(18,2) Total del ítem = (Precio final x cantidad) - bonificacion)
Gravado Boolean Indica si el ítem es gravado.
ERRORES DE VALIDACIÓN DE Facturante.com
Código Descripción
0 (SinDetalle) Sin Detalles
1 (ObjAutenticacionNull) El objeto Autenticación no pudo ser creado con los datos recibidos
4 (UsuarioInvalido) Usuario incorrecto
500 (ErrorInterno) Error interno.