Integración ERP: SAP Business One
SAP Business One es el ERP de SAP orientado a pequeñas y medianas empresas. La integración se realiza mediante Service Layer — la API REST nativa de SAP B1 —, que expone las entidades del sistema de forma estandarizada.
Este artículo orienta la configuración de la credencial y detalla los informes disponibles de este conector. Para el paso a paso de uso en el flujo de preparación de datos — selección del conector, credencial, informe y parámetros — consulta el artículo Etapa ERP.
Configuración de la Credencial
Campo | Descripción | Obligatorio |
|---|---|---|
Host | URL base del servidor SAP Business One Service Layer (ej: | Sí |
Company DB | Nombre de la base de datos de la empresa en SAP B1 (ej: | Sí |
Usuario | Usuario de integración de SAP B1 | Sí |
Contraseña | Contraseña del usuario | Sí |
Consejo: El usuario debe tener permiso de acceso a las entidades utilizadas en los informes. Se recomienda crear un usuario de integración dedicado con los permisos mínimos necesarios.
Informes Disponibles
Módulo: Socios de Negocio
Socios de Negocio
Devuelve clientes, proveedores y leads registrados en SAP Business One.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio | Opciones |
|---|---|---|---|
CardType | Tipo de socio | No |
|
FederalTaxID | CNPJ/CPF para filtrar un socio específico (ej: | No | — |
Campos devueltos:
Campo | Descripción |
|---|---|
CardCode | Código del socio |
CardName | Nombre / Razón social |
CardType | Tipo (Cliente / Proveedor / Lead) |
GroupCode | Código del grupo |
FederalTaxID | CNPJ/CPF |
Phone1 | Teléfono |
EmailAddress | Correo electrónico |
Currency | Moneda predeterminada |
CurrentAccountBalance | Saldo actual |
Valid | Socio activo |
Frozen | Socio bloqueado |
CreateDate | Fecha de creación |
Módulo: Inventario
Artículos / Productos
Devuelve el registro de artículos y productos registrados en SAP B1.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio | Opciones |
|---|---|---|---|
ItemType | Tipo de artículo | No |
|
ItemsGroupCode | Código del grupo de artículos | No | — |
Campos devueltos:
Campo | Descripción |
|---|---|
ItemCode | Código del artículo |
ItemName | Descripción del artículo |
ItemsGroupCode | Grupo de artículos |
InventoryItem | ¿Es artículo de inventario? |
SalesItem | ¿Es artículo de venta? |
PurchaseItem | ¿Es artículo de compra? |
QuantityOnStock | Cantidad en inventario |
BarCode | Código de barras |
ManageBatchNumbers | ¿Controla lotes? |
CreateDate | Fecha de creación |
ItemPrices.PriceList | Lista de precios |
ItemPrices.Price | Precio |
ItemPrices.Currency | Moneda del precio |
Depósitos / Almacenes
Devuelve los depósitos (warehouses) registrados en SAP B1.
Parámetros de filtro: Ningún parámetro de filtro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
WarehouseCode | Código del depósito |
WarehouseName | Nombre del depósito |
Street | Calle |
City | Ciudad |
State | Estado |
Country | País |
DefaultBin | Bin predeterminado |
Inactive | ¿Depósito inactivo? |
Entradas de Inventario
Registros de entradas sueltas de mercancías en inventario (sin factura de compra).
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial (formato | No |
DocDateTo | Fecha final (formato | No |
Campos devueltos:
Campo | Descripción |
|---|---|
DocEntry | ID interno del documento |
DocNum | Número del documento |
DocDate | Fecha del documento |
Comments | Observaciones |
DocumentLines.LineNum | Número de línea |
DocumentLines.ItemCode | Código del artículo |
DocumentLines.Quantity | Cantidad |
DocumentLines.WarehouseCode | Depósito |
DocumentLines.Price | Precio |
Salidas de Inventario
Registros de salidas sueltas de mercancías del inventario (sin factura de venta).
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos: Mismos campos de Entradas de Inventario.
Transferencias de Inventario
Registros de transferencias de mercancías entre depósitos.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
DocEntry | ID interno del documento |
DocNum | Número del documento |
DocDate | Fecha de la transferencia |
FromWarehouse | Depósito de origen |
ToWarehouse | Depósito de destino |
Comments | Observaciones |
StockTransferLines.LineNum | Línea |
StockTransferLines.ItemCode | Código del artículo |
StockTransferLines.Quantity | Cantidad |
StockTransferLines.FromWarehouseCode | Depósito de origen (línea) |
StockTransferLines.WarehouseCode | Depósito de destino (línea) |
Módulo: Contabilidad
Plan de Cuentas
Devuelve la estructura del plan de cuentas configurado en SAP B1.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio | Opciones |
|---|---|---|---|
AccountType | Tipo de cuenta | No |
|
Campos devueltos:
Campo | Descripción |
|---|---|
Code | Código de la cuenta |
Name | Nombre de la cuenta |
AccountType | Tipo de cuenta |
ActiveAccount | ¿Cuenta activa? |
CurrentAccountBalance | Saldo actual |
FatherAccountKey | Cuenta padre (jerarquía) |
Level | Nivel en la jerarquía |
Details | Detalles adicionales |
Asientos Contables
Devuelve los asientos contables (journal entries) del período.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
ReferenceDateFrom | Fecha inicial de referencia. Se completa automáticamente con el 1.º día del mes de referencia | No |
ReferenceDateTo | Fecha final de referencia. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
JdtNum | Número del asiento |
ReferenceDate | Fecha de referencia |
DueDate | Fecha de vencimiento |
Memo | Memorando / histórico |
Reference | Referencia |
TransactionCode | Código de transacción |
JournalEntryLines.Line_ID | ID de la línea |
JournalEntryLines.AccountCode | Cuenta contable |
JournalEntryLines.Debit | Débito |
JournalEntryLines.Credit | Crédito |
JournalEntryLines.ShortName | Socio relacionado |
Módulo: Cuentas por Cobrar
Facturas de Salida (Facturas de Venta)
Devuelve las facturas de salida emitidas a clientes.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial del documento. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final del documento. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
DocEntry | ID interno |
DocNum | Número de la factura |
DocType | Tipo de documento |
DocDate | Fecha de emisión |
DocDueDate | Fecha de vencimiento |
CardCode | Código del cliente |
CardName | Nombre del cliente |
DocTotal | Valor total |
DocumentStatus | Estado (abierto/cerrado) |
Comments | Observaciones |
DocumentLines.* | Ítems de la factura (código, descripción, cantidad, precio, total, impuesto) |
Notas de Crédito de Venta
Devuelve las notas de crédito emitidas a clientes (devoluciones de venta).
Parámetros de filtro: Mismos que Facturas de Salida.
Campos devueltos: Mismos que Facturas de Salida.
Cobros
Devuelve los pagos recibidos de clientes.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos:
Campo | Descripción |
|---|---|
DocEntry | ID interno |
DocNum | Número del cobro |
DocDate | Fecha del cobro |
CardCode | Código del cliente |
CardName | Nombre del cliente |
DocCurrency | Moneda |
CashSum | Importe en efectivo |
TransferSum | Importe por transferencia |
CheckSum | Importe en cheques |
DocType | Tipo de documento |
Módulo: Compras
Órdenes de Compra
Devuelve las órdenes de compra emitidas a proveedores.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos: Similares a Facturas de Salida, pero con datos de proveedores y depósito.
Módulo: Cuentas por Pagar
Facturas de Entrada (Facturas de Compra)
Devuelve las facturas de entrada recibidas de proveedores.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos: Similares a Facturas de Salida, con datos del proveedor.
Notas de Crédito de Compra
Devuelve notas de crédito de compra (devoluciones al proveedor).
Parámetros de filtro: Mismos que Facturas de Entrada.
Pagos a Proveedores
Devuelve los pagos realizados a proveedores.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos: Mismos que Cobros.
Módulo: Ventas
Pedidos de Venta
Devuelve los pedidos de venta registrados en SAP B1.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
DocDateFrom | Fecha inicial. Se completa automáticamente con el 1.º día del mes de referencia | No |
DocDateTo | Fecha final. Se completa automáticamente con el último día del mes de referencia | No |
Campos devueltos: Similares a Facturas de Salida.
Parámetros Fijos (gestionados automáticamente)
Parámetro | Valor predeterminado | Motivo |
|---|---|---|
|
| Límite de registros por página. Valor controlado para evitar sobrecarga en la API de SAP B1 |
| (lista de campos preconfigurada) | Define los campos devueltos, optimizando el volumen de datos transferidos |
Artículos relacionados
Etapa ERP
Introducción a las integraciones
Integraciones personalizadas vía API Rest y conectores SQL