Ingresar

API Facturas de Proveedores

Casos de uso

  • Registrar compras contado y crédito.
  • Registrar compras de gastos y sus notas correctivas.
  • Incorporar pedidos y remitos de proveedores.
  • Registrar recibos de pago.
  • Consultar compras de proveedores por período.
  • Consultar movimientos de stock vinculados a proveedores.
  • Obtener comprobantes con saldo pendiente.
  • Obtener compras resumidas o detalladas para análisis e integración.

Endpoint del servicio

Requisitos previos

  • Acceso habilitado a la API.
  • Conocimiento de la configuración funcional de la empresa.
  • Disponibilidad de códigos válidos de comprobante, proveedor, moneda, condición de pago, depósitos, centro de costo, local, usuario y caja.
  • Validación previa de artículos, conceptos, IVA y formas de pago según el tipo de comprobante a registrar.

Método Agregar

Permite generar nuevos comprobantes de proveedores, incluyendo compras contado, compras crédito, compras de gastos, notas correctivas, movimientos de stock y recibos de pago.

Importante: El código del local informado en el cabezal es obligatorio y debe corresponder al local del comprobante. Este valor será validado por el sistema.
En comprobantes de gastos, en las líneas de conceptos se puede informar un código de local diferente al del encabezado. En estos casos, el local indicado en la línea solo debe existir en el sistema, no es necesario que coincida con el local del comprobante.
Si en las líneas no se informa CodigoLocalLinea, el sistema tomará automáticamente el mismo código de local definido en el encabezado.

Parámetros del encabezado

CampoTipoObligatorioDescripción
CodigoComprobanteN(3)SíTipo de comprobante a generar.
SerieT(6)NoSerie del comprobante.
NumeroN(10)NoNúmero del comprobante.
FechaAAAAMMDDSíFecha del comprobante.
CodigoMonedaN(2)SíMoneda del movimiento.
CotizacionN(7.7)NoCotización de la moneda.
CodigoProveedorN(10)SICódigo del proveedor.
CodigoCondicionPagoN(3)NoCondición de pago.
CodigoDepositoOrigenN(3)NoDepósito de origen.
CodigoDepositoDestinoN(3)NoDepósito de destino.
CodigoCentroCostoT(10)NoCentro de costo asociado.
CodigoReferenciaN(10)NoReferencia externa.
NotasT(30)NoNotas del comprobante.
CodigoLocalN(3)SICódigo del local.
CodigoUsuarioN(3)SICódigo del usuario que registra la operación.
CodigoCajaN(3)SICódigo de caja.

Líneas del comprobante

Debe enviarse una línea por cada artículo o concepto incluido en el comprobante.

CampoTipoDescripción
CodigoArticuloT(20) / T(10)Obligatorio. T(20) para artículos en compras. T(10) para conceptos en compras de gastos.
ConceptoT(50)Descripción de la línea.
CodigoLoteT(20)Obligatorio si el artículo opera con lotes.
VencimientoAAAA-MM-DDObligatorio si el artículo tiene vencimiento.
CantidadN(17.5)Obligatorio. Debe ser mayor a cero.
PrecioUnitarioN(17.5)Precio unitario. El sistema calcula neto, IVA y total según configuración.
Descuento1N(5.2)Descuento opcional. En compras de gastos debe ser cero.
Descuento2N(5.2)Descuento opcional. En compras de gastos debe ser cero.
Descuento3N(5.2)Descuento opcional. En compras de gastos debe ser cero.
CodigoIVAN(2)Código de IVA aplicable a la línea.
NotasT(1000)Observaciones adicionales de la línea.
CodigoLocalLineaN(3)Código del local de la línea. Se utiliza en facturas de compra definidas como gastos. Si se envía vacío o en cero, la línea toma el local informado en el encabezado. Si se informa un código, se valida que el local exista y se graba ese local en la línea.

Formas de pago

CampoTipoDescripción
CodigoFormaPagoN(3)Forma de pago utilizada.
CodigoMonedaPagoN(2)Moneda en la que se realiza el pago.
MontoMonedaPagoN(17.2)Importe pagado en la moneda del pago.
MontoMonedaMovimientoN(17.2)Importe equivalente en la moneda del movimiento.

Resultado

Ok
Error
Mensaje

Método QueryCompras

Permite consultar comprobantes de compra de un proveedor en un período determinado.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
MesT(MM)SíMes de la consulta.
AnioT(AAAA)SíAño de la consulta.
FechaDesdeAAAA-MM-DDNoFecha inicial.
FechaHastaAAAA-MM-DDNoFecha final.
ProveedorCodigoT(10)SíCódigo del proveedor.
ComprobanteCodigoN(3)NoTipo de comprobante.
MonedaCodigoN(2)NoMoneda del comprobante.
LocalCodigoN(3)NoCódigo del local.
PageN(2)SíNúmero de página.

Campos principales devueltos

RegistroId
Fecha
ComprobanteCodigo
ComprobanteNombre
ComprobanteTipo
ComprobanteTipoNombre
EsGasto
Serie
Numero
ProveedorCodigo
ProveedorNombre
ProveedorRazonSocial
ProveedorPaisCodigo
ProveedorPaisNombre
ProveedorDepartamentoCodigo
ProveedorDepartamentoNombre
ProveedorGrupoCodigo
ProveedorGrupoNombre
ProveedorGiroCodigo
ProveedorGiroNombre
ProveedorZonaCodigo
ProveedorZonaNombre
ProveedorCategoriaCodigo
ProveedorCategoriaNombre
MonedaCodigo
MonedaSimbolo
CotizacionEspecial
CondicionCodigo
CondicionNombre
LocalCodigo
LocalNombre
CajaCodigo
CajaNombre
CentroCostosCodigo
CentroCostosNombre
Referencia
DepositoOrigenCodigo
DepositoOrigenNombre
DepositoDestinoCodigo
DepositoDestinoNombre
Subtotal
SubtotalSigno
IVA
IVASigno
Total
TotalSigno
Saldo
SaldoSigno
Emitido
UsuarioCodigo
UsuarioNombre
RegistroFecha
RegistroHora

Método QueryMovimientosStock

Permite consultar comprobantes asociados a movimientos de stock de proveedores, como remitos y pedidos.

Parámetros de entrada

 

ParámetroTipoObligatorioDescripción
MesT(MM)SíMes de la consulta.
AnioT(AAAA)SíAño de la consulta.
FechaDesdeDateNoFecha inicial.
FechaHastaDateNoFecha final.
SerieStringNoSerie del comprobante.
NumeroDesdeLongNoNúmero inicial.
NumeroHastaLongNoNúmero final.
ProveedorCodigoStringNoCódigo del proveedor.
ComprobanteCodigoShortNoTipo de comprobante.
MonedaCodigoByteNoCódigo de moneda.
LocalCodigoShortNoCódigo del local.
PendienteSNStringNoS, N o vacío. Indica si existen artículos pendientes.
PageN(2)SiNúmero de página.

Campos principales devueltos

RegistroId
Fecha
ComprobanteCodigo
ComprobanteNombre
EsCFE
Serie
Numero
ProveedorCodigo
ProveedorNombre
ProveedorRazonSocial
ProveedorPaisCodigo
ProveedorPaisNombre
ProveedorDepartamentoCodigo
ProveedorDepartamentoNombre
ProveedorGrupoCodigo
ProveedorGrupoNombre
ProveedorGiroCodigo
ProveedorGiroNombre
ProveedorZonaCodigo
ProveedorZonaNombre
ProveedorCategoriaCodigo
ProveedorCategoriaNombre
MonedaCodigo
MonedaSimbolo
CotizacionEspecial
PrecioVentaCodigo
PrecioVentaNombre
CondicionCodigo
CondicionNombre
VendedorCodigo
VendedorNombre
LocalCodigo
LocalNombre
CentroCostosCodigo
CentroCostosNombre
Referencia
DepositoOrigenCodigo
DepositoOrigenNombre
DepositoDestinoCodigo
DepositoDestinoNombre
Subtotal
IVA
Total
Pendiente
Emitido
Notas
UsuarioCodigo
UsuarioNombre
RegistroFecha
RegistroHora

Método QuerySaldosPendientes

Permite consultar comprobantes de proveedores con saldo pendiente, incluyendo compras crédito y notas de crédito.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
ProveedorCodigoT(10)NoCódigo del proveedor. Si se envía vacío, consulta todos los proveedores.
Id–SíDebe enviarse vacío.
ComprobanteCodigoN(3)NoTipo de comprobante.
FechaDesdeAAAAMMDDNoFecha inicial.
FechaHastaAAAAMMDDNoFecha final.
SerieT(6)NoSerie del comprobante.
NumeroN(10)NoNúmero del comprobante.
MonedaCodigoN(2)NoCódigo de moneda.
LocalCodigoN(4)NoCódigo del local.
SaldoDesdeN(10)NoImporte mínimo del saldo.
SaldoHastaN(10)NoImporte máximo del saldo.
EmitidoT(1)NoS, N o vacío.
PageN(2)SíNúmero de página.

Campos devueltos

RegistroId
ComprobanteCodigo
ComprobanteAbreviacion
ComprobanteNombre
ComprobanteTipo
ComprobanteTipoNombre
ProveedorCodigo
ProveedorNombre
ProveedorRazonSocial
Fecha
Serie
Numero
MonedaCodigo
MonedaSimbolo
MonedaNombre
CondicionCodigo
CondicionNombre
LocalCodigo
LocalNombre
Total
TotalSigno
Saldo
SaldoSigno
Emitido
Notas

Método Compras

Permite obtener un listado resumido de comprobantes de proveedores registrados en el sistema.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
MesT(MM)SíMes de la consulta.
AnioT(AAAA)SíAño de la consulta.
MonedaN(2)NoMoneda de salida.

Campos principales devueltos

FacturaId
FacturaFecha
FacturaDia
FacturaMes
FacturaAnio
MonedaCodigo
MonedaSimbolo
Cotizacion
ComprobanteCodigo
ComprobanteNombre
ComprobanteTipo
FacturaGastos
FacturaSigno
FacturaSerie
FacturaNumero
FacturaSerieNumero
LocalCodigo
LocalNombre
DepositoOrigenCodigo
DepositoOrigenNombre
DepositoDestinoCodigo
DepositoDestinoNombre
CajaCodigo
CajaNombre
CondicionPagoCodigo
CondicionPagoNombre
FacturaReferencia
CentroCostosCodigo
CentroCostosNombre
UsuarioCodigo
UsuarioNombre
FacturaRegistroFecha
FacturaRegistroHora
ProveedorCodigo
ProveedorNombre
ProveedorRazonSocial
GrupoCodigo
GrupoNombre
GiroCodigo
GiroNombre
PaisCodigo
PaisNombre
DepartamentoCodigo
DepartamentoNombre
ZonaCodigo
ZonaNombre
CategoriaCodigo
CategoriaNombre
FacturaDescuentos
FacturaSubtotal
FacturaIVA
FacturaTotal
FacturaSaldo

Método ComprasDetalladas

Permite obtener compras con detalle de líneas de artículos o conceptos.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
MesT(MM)SíMes de la consulta.
AnioT(AAAA)SíAño de la consulta.
MonedaN(2)NoSi se envía vacío, contempla todas las monedas.

Encabezado del comprobante

FacturaId
FacturaFecha
FacturaDia
FacturaMes
FacturaAnio
MonedaCodigo
MonedaSimbolo
Cotizacion
ComprobanteCodigo
ComprobanteNombre
ComprobanteTipo
FacturaGastos
FacturaSigno
FacturaSerie
FacturaNumero
FacturaSerieNumero
LocalCodigo
LocalNombre
DepositoOrigenCodigo
DepositoOrigenNombre
DepositoDestinoCodigo
DepositoDestinoNombre
CajaCodigo
CajaNombre
CondicionPagoCodigo
CondicionPagoNombre
FacturaReferencia
CentroCostosCodigo
CentroCostosNombre
UsuarioCodigo
UsuarioNombre
FacturaRegistroFecha
FacturaRegistroHora
ProveedorCodigo
ProveedorNombre
ProveedorRazonSocial
GrupoCodigo
GrupoNombre
GiroCodigo
GiroNombre
PaisCodigo
PaisNombre
DepartamentoCodigo
DepartamentoNombre
ZonaCodigo
ZonaNombre

Detalle de líneas

CategoriaCodigo
CategoriaNombre
ArticuloCodigo
ArticuloNombre
MarcaCodigo
MarcaNombre
CategoriaArticuloCodigo
CategoriaArticuloNombre
FamiliaCodigo
FamiliaNombre
ConceptoCodigo
ConceptoNombre
LineaConcepto
LineaLoteCodigo
LineaLoteVencimiento
LineaCantidad
LineaPrecioDigitado
LineaPrecio
LineaDtoPorcentaje1
LineaDtoPorcentaje2
LineaDtoPorcentaje3
IVACodigo
IVATasa
IVANombre
IVATipo
LineaPendienteRemision
LineaDescuentos
LineaSubtotal
LineaIVA
LineaTotal
LocalCodigoLinea

Observaciones

  • La API está diseñada para insertar nuevos movimientos. No permite modificación de comprobantes ya registrados.
  • En compras de gastos, los descuentos de línea deben enviarse en cero.
  • Al agregar compras de gastos, CodigoLocalLinea permite indicar un local diferente por línea. Si no se informa, o se informa en cero, se utiliza el CodigoLocal del encabezado. Si se informa CodigoLocalLinea, el sistema valida la existencia del local antes de grabar la línea.
  • Los importes de las formas de pago deben ser consistentes con el total del movimiento.
  • Los cálculos de neto, IVA y total dependen de la configuración del comprobante, del proveedor y del IVA aplicado a cada línea.
API Facturas de Proveedores - PreviousAPI Facturas de ClientesNext - API Facturas de ProveedoresAPI Movimientos Bancarios
Compartir

API Facturas de Proveedores

O copia el enlace

CONTENIDO