> ## Documentation Index > Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt > Use this file to discover all available pages before exploring further. # Facturas de compra > API para el registro de facturas de compra En SEDI ERP, las facturas de compra son el documento previo a la cuenta por pagar, representan los documentos soporte de las compras realizadas por la empresa ## Prerequisitos Antes de realizar el registro de una factura de compra, se debe contar con los siguientes datos: * Token solicitado mediante el API de [autenticación](https://tech.sedierp.com/quickstart.md) * Datos de la factura de compra a registrar ## Como generar el token JWT **Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/FacturaCompraInsertar\ **Tipo:** POST \ **Content Type:** application/json **TipoDocumento** `int` *required* Tipo de documento de identificación del proveedor, se debe colocar el Código correspondiente a la siguiente tabla ![Tipos Documentos](https://mintcdn.com/sedi-solutions-sas/GIw7WqTvI4uIXmWB/images/tipos-documentos.png?fit=max\&auto=format\&n=GIw7WqTvI4uIXmWB\&q=85\&s=4972cedc7a553835f30e959fa753fd0a) **Documento** `string` *required* Número de identificación del proveedor, debe ir el número sin puntos ni comas ni espacios. **TipoPersona** `string` *required* Tipo de persona del proveedor, debe ir el número del código correspondiente a persona jurídica o persona natural. ![Image](https://mintcdn.com/sedi-solutions-sas/GIw7WqTvI4uIXmWB/images/tipos-personas.png?fit=max\&auto=format\&n=GIw7WqTvI4uIXmWB\&q=85\&s=164fb63e50f4594e0582e1acb1eaa7e2) **Nombres** `string` *required* Debe ir el primer nombre del proveedor en caso de ser natural, en caso de ser jurídico debe ir la razón social este campo. **Nombres2** `string` *required* Deben ir los otros nombres del proveedor. **Apellidos** `string` Debe ir el primer apellido del proveedor. **Apellidos2** `string` Debe ir el segundo apellido del proveedor. **Direccion** `string` Debe corresponder a la dirección del lugar físico del proveedor. **Celular** `string` Debe corresponder al número de celular del proveedor. **Email** `string` Debe corresponder al email (correo electrónico) del proveedor. **ResponsabilidadTributaria** `string` Se debe indicar la responsabilidad tributaria del proveedor. ![Image](https://mintcdn.com/sedi-solutions-sas/GIw7WqTvI4uIXmWB/images/responsabilidades.png?fit=max\&auto=format\&n=GIw7WqTvI4uIXmWB\&q=85\&s=9ea5a78204dfeb4a770a9a5f50353f63) **Pais** `string` Si el país es Colombia se debe enviar ‘**CO**’, en caso de ser otro país debe enviar el codigo según la siguiente [lista de paises](https://tech.sedierp.com/paises.md) **Ciudad** `string` Se debe enviar la información que se encuentra en la siguiente tabla, ejemplo: si el proveedor se encuentra en la ciudad de **Bogotá** se debe enviar la información que se encuentra en la columna Código ciudad "**11001",** si se requiere otra ciudad, puede validar el [listado de ciudades](https://tech.sedierp.com/ciudades.md) **NumeroFacturaCompra** `string` *required* Número de la factura de compra, ejemplo: **FV12345**, **FE12345**, **12345**. **FechaEmision** `DateTime` *required* Fecha de emisión a la entidad fiscal (DIAN, SUNAT, SAT, SRI) de la factura, ejemplo: 2022-07-19T16:01:33.233Z. **FechaVencimiento** `DateTime` *required* Fecha de vencimiento de la factura, ejemplo: 2022-07-19T16:01:33.233Z **TipoFacturaCompra** `string` *required* Se debe enviar un codigo correspondiente de acuerdo al siguiente listado ![Image](https://mintcdn.com/sedi-solutions-sas/GIw7WqTvI4uIXmWB/images/tipos-facturas.png?fit=max\&auto=format\&n=GIw7WqTvI4uIXmWB\&q=85\&s=c02fbdd80007f38f5056f4cb6c10c146) **CUFE** `string` *required* Se debe enviar el CUFE de la factura (en paises diferentes a colombia, el codigo unico de la factura) **Observaciones** `string` Se debe enviar las observaciones de la factura. **UsuarioEmail** `string` Se debe enviar el email o correo del usuario previamente creado en la plataforma. **Detalles de la factura de compra (FacturasCompraDetalles)** **NumeroLinea** `int` Número de la línea en la que debe estar el detalle o concepto **Concepto** `string` *required* Descripción del detalle o concepto. **ValorUnitario** `float` *required* Valor unitario del detalle o concepto. **Cantidad** `string` *required* Cantidad del detalle o concepto. **Descuento** `float` *required* Valor de descuentos del detalle o concepto (si no aplica descuentos se debe enviar el valor en 0). **Cargos** `string` Cargos del detalle o concepto. **ValorTotal** `float` *required* Valor total del detalle o concepto. **ValorTotal** `float` *required* Valor total del detalle o concepto. **Impuestos o retenciones del concepto (Impuestos)** **CodigoImpuesto** `string` *required* Se debe enviar el código del impuesto tal como se detallada a continuación. ![Image](https://mintcdn.com/sedi-solutions-sas/GIw7WqTvI4uIXmWB/images/tipos-impuestos.png?fit=max\&auto=format\&n=GIw7WqTvI4uIXmWB\&q=85\&s=91cf43d41f5c4dc2ce2696f997b676a7) **Porcentaje** `float` *required* Se debe enviar el porcentaje del impuesto. **ValorImpuesto** `float` *required* Se debe enviar el valor del impuesto. **Archivos adjuntos de la factura (FacturasCompraAdjuntos)** **Nombre** `string` *required* se debe enviar el nombre del archivo anexo o adjunto. **Ruta** `string` *required* se debe enviar la ruta URL del archivo anexo o adjunto. **Recargos o descuentos a pie de factura (FacturasCompraDescuentosRecargos)** **Tipo** `bool` *required* true = Descuento o false = Recargo **Concepto** `string` *required* descripción del concepto por descuento o recargo. **Valor** `float` *required* valor del concepto por descuento o recargo. **Persona (Persona)** **TipoDocumento** `string` *required* tipo de documento de identificación de la persona para emitir el primer evento de **RADIAN** correspondiente al (**030**) Acuse de recibo de la Factura Electrónica de Venta ![Image](https://mintcdn.com/sedi-solutions-sas/GIw7WqTvI4uIXmWB/images/tipos-documentos.png?fit=max\&auto=format\&n=GIw7WqTvI4uIXmWB\&q=85\&s=4972cedc7a553835f30e959fa753fd0a) **Documento** `string` *required* número de identificación de la persona para emitir el primer evento de RADIAN correspondiente al (030) Acuse de recibo de la Factura Electrónica de Venta, debe ir el número sin puntos ni comas ni espacios. **Nombres** `string` *required* debe ir el primer nombre de la persona para emitir el primer evento de RADIAN correspondiente al (030) Acuse de recibo de la Factura Electrónica de Venta. **Apellidos** `string` debe ir el primer apellido de la persona para emitir el primer evento de RADIAN correspondiente al (030) Acuse de recibo de la Factura Electrónica de Venta. ```json Request theme={null} { "TipoDocumento": 0, "Documento": "string", "TipoPersona": 0, "Nombres": "string", "Nombres2": "string", "Apellidos": "string", "Apellidos2": "string", "Direccion": "string", "Celular": "string", "Email": "string", "ResponsabilidadTributaria": "string", "Pais": "string", "Ciudad": "string", "NumeroFacturaCompra": "string", "FechaEmision": "2022-07-19T14:41:54.323Z", "FechaVencimiento": "2022-07-19T14:41:54.323Z", "TipoFacturaCompra": "string", "CUFE": "string", "Observaciones": "string", "UsuarioEmail": "string", "FacturasCompraDetalles": [ { "NumeroLinea": 0, "Concepto": "string", "ValorUnitario": 0, "Cantidad": 0, "Descuento": 0, "Cargos": 0, "ValorTotal": 0, "Impuestos": [ { "CodigoImpuesto": "string", "Porcentaje": 0, "ValorImpuesto": 0 } ] } ], "FacturasCompraAdjuntos": [ { "Nombre": "string", "Ruta": "string" } ], "FacturasCompraDescuentosRecargos": [ { "Tipo": true, "Concepto": "string", "Valor": 0 } ], "Persona": { "TipoDocumento": "string", "Documento": "string", "Nombres": "string", "Apellidos": "string" }, "Token": "00000000-0000-0000-0000-000000000000" } ``` ```json Response theme={null} { "FacturaCompraID": 1250, "Consecutivo": 125, "TerceroID": 350, "ProveedorID": 45, "ProveedorCompraID": 45, "NumeroDocumento": "FC-2026-00125", "OrigenFacturaCompraID": 2, "CodigoOrigen": 890, "Electronica": true, "FechaEmision": "2026-11-03T00:00:00", "FechaVencimiento": "2026-12-03T00:00:00", "FechaRegistro": "2026-11-03T13:30:00", "UsuarioID": 10, "Observaciones": "Factura correspondiente a compra de insumos.", "RutaXML": null, "UUID": null, "ValidoDIAN": false, "SucursalID": 1, "UniqueID": "a1b2c3d4-e5f6-4789-a123-123456789abc", "PasivoCuentaContableID": 250, "GastoCuentaContableID": 350, "GrupoAprobacionFacturasCompraID": 1, "CentroCostoID": 15, "EstadoAprobacionFacturaCompraID": 1, "AcuseRecibidoBienServicio": false, "TipoReclamoID": null, "ValorNeto": 1000000.00, "ValorImpuestos": 190000.00, "Contabilidad": true, "ObservacionesContabilidad": null, "NotificacionEventos": false, "TieneCuentaServicio": false, "IsEdicionFactura": false, "CuentaServicio": {}, "NombreCompleto": "PROVEEDOR DE EJEMPLO S.A.S.", "Documento": "900123456", "Celular": "3001234567", "Direccion": "Calle 100 # 15-20", "Email": "proveedor@ejemplo.com", "Telefono": "6011234567", "AbreviaturaDocumento": "NIT. 900.123.456", "OrigenFacturaCompraNombre": "Orden de compra", "UsuarioNombreCompleto": "ADMINISTRADOR DEL SISTEMA", "CentroCostoCodigoNombre": "001 - ADMINISTRACIÓN", "GrupoAprobacionFacturasCompraNombre": "APROBACIÓN GENERAL", "EstadoAprobacionFacturaCompraNombre": "Aprobada", "TipoReclamoNombre": null, "SucursalNombre": "PRINCIPAL", "TipoFacturaCompraNombre": "Factura de compra", "TipoPagoNombre": "Crédito", "CodigoOrigenNombre": "Orden Compra Nº - 0890 - PROVEEDOR DE EJEMPLO S.A.S.", "FacturasCompraAdjuntos": [ { "FacturasCompraAdjuntoID": 10, "Nombre": "FacturaCompra.pdf", "Ruta": "Facturas/FacturaCompra.pdf", "Base64": "https://empresa.com/ArchivosCargados/Facturas/FacturaCompra.pdf", "RutaHttp": "https://empresa.com/ArchivosCargados/Facturas/FacturaCompra.pdf" } ], "Impuestos": [ { "ImpuestoID": 1, "ImpuestoNombre": "IVA", "ImpuestoPorcenatje": 19, "TipoImpuestoID": 1, "TipoImpuestoNombre": "IVA", "ValorImpuesto": 190000.00 } ], "FacturasCompraDetalles": [ { "FacturaCompraDetalleID": 500, "NumeroLinea": 1, "ProductoID": 100, "ProductoNombre": "PRODUCTO DE EJEMPLO", "Cantidad": 10, "ValorUnitario": 100000.00, "Descuento": 0, "Cargos": 0, "ValorTotal": 1000000.00, "CodigoExterno": "PROD-001", "ProductoCatalogo": { "ProductoID": 100, "Nombre": "PRODUCTO DE EJEMPLO", "Abreviatura": "PROD", "UnidadProductoNombre": "Unidad", "FactorInventario": 1, "InventarioID": 10 }, "Impuestos": [ { "FacturaCompraDetalleImpuestoID": 700, "ImpuestoID": 1, "ValorImpuesto": 190000.00, "ImpuestoNombre": "IVA 19 %", "Porcentaje": 19, "TipoImpuestoID": 1, "TipoImpuestoNombre": "IVA" } ] } ], "FacturasCompraRecargosDescuentos": [ { "FacturaCompraRecargoDescuentoID": 20, "TipoRecargoDescuentoID": 1, "Concepto": "Descuento comercial", "Valor": 50000.00, "TipoRecargoDescuentoNombre": "Descuento" } ], "FacturasCompraAprobacionesJerarquias": [ { "FacturaCompraAprobacionJerarquiaID": 30, "JerarquiaAprobacionFacturaCompraID": 1, "Orden": 1, "EstadoAprobacionFacturaCompraID": 1, "UsuarioNombreCompleto": "ADMINISTRADOR DEL SISTEMA", "Fecha": "2026-11-03T13:35:00", "Observaciones": "Aprobada.", "EstadoAprobacionFacturaCompraNombre": "Aprobada" } ], "FacturasCompraReferencias": [ { "FacturaCompraReferenciaID": 40, "Referencia": "OC-0890" } ], "EventosDian": [ { "Consecutivo": 1, "FechaGeneracion": "2026-11-03T13:40:00", "EventoAplicationResponse": "Acuse de recibo", "Prefijo": "030", "CUDE": "CUDE-DE-EJEMPLO", "RespuestaDIAN": { "Respuesta": "Evento procesado correctamente" }, "EstadoAplicationResponseID": 1, "EstadoAplicationResponse": "Procesado" } ] } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.