Insertar Primarios Con Detalle En Bloque Sector Salud

Crea un nuevo Documento Primario con detalle en bloque para el Sector Salud.

Atributos

Endpoint

MÉTODO	URL
POST	`http://144.202.47.24/{instancia_cliente}/RestServerIsapi.dll/api/v1/TApoloRestInterface/execute`

En la variable {instancia_cliente} se indica el nombre de la instancia proporcionado por Apolosoft en el momento de la configuración.

Cuerpo

CAMPO	DESCRIPCIÓN	TAMAÑO	OBSERVACIÓN
CLAVE	Nombre de la API	50	Para este caso es `Set_Gestion_Primario_S`.
TIPO	Código del documento primario.	5	Debe existir en el ERP.
PREFIJO	Prefijo del documento primario.	5	Debe existir en el ERP. Si no lo maneja, debe ir guión bajo `_`.
NUMERO	Número del documento primario.	10
FECHA	Fecha del documento primario.		[DD.MM.AAAA]
VENCE	Fecha de vencimiento del documento primario.		[DD.MM.AAAA]
ANTICIPO	Valor a descontar de la factura por recaudos previos.		Debe ser de tipo float.
TERCERO	CC/NIT del cliente o proveedor.	15	Sin dígito de verificación [DV].
VENDEDOR	CC del vendedor.	15	Si no lo maneja, debe ir [NA].
LISTA	Código lista de precio.	5	Si no lo maneja, debe ir [NA].
BANCO	Código de la caja o banco.	5	Si no lo maneja, debe ir [NA].
USUARIO	Usuario ERP en el que va a quedar registrado el movimiento.	10
NOTA	Nota para el encabezado del documento.	80
RESUMEN	Código de un resumen creado previamente.	10	Puede crear estos usando el endpoint para insertar resumen.
CONTRATO	Código establecido en Mekano generado con la entidad de salud.	15
POLIZA	Número de póliza si se requiere.	15	Puede ir vacío.
DETALLE	Bloque que contiene el detalle de la factura. Cada campo separado por `,`, cada renglón separado por `\|`. Ver ejemplo		Los campos están explicados en la tabla siquiente.
BLOQUEADO	Define si el documento sube bloqueado al ERP, alimentando información al módulo contable, cartera, inventario, etc.	1	S/N
ENVIADO	Define si el documento debe ser enviado a la Dian de forma inmediata.	1	S/N Debe adquirir el servicio que activa este envío inmediato

Los campos RESUMEN y CONTRATO son mutuamente excluyentes. Si establece uno, el otro debe ir vacío.

Cuando se envían ambos campos, la API responde de esta manera:

{
  "cod_error": 0,
  "ex_execsql": "[FireDAC][Phys][FB]exception 10\r\nREST_ERROR\r\n*** NO PUEDE ENVIAR RESUMEN Y CONTRATO AL MISMO TIEMPO ***\r\nAt procedure 'REST_INSERT_GESTION_PRIMARIO_S' line: 156, col: 7"
}

Campos del detalle

Campo	Descripción	Tamaño	Observación
CENTRO	Código del centro de costos.	5
BODEGA	Código de la bodega.	5
REFERENCIA	Código de la referencia o producto.	20
ENTRADA	Cantidad para compras o entradas.	17,4	Si no aplica, debe ir con valor 0.
SALIDA	Cantidad para ventas o salidas.	17,4	Si no aplica, debe ir con valor 0.
UNITARIO	Valor por unidad.	17,4	El valor debe ir de acuerdo a la configuración del documento, ya sea con IVA incluido o antes de IVA.
PORCENTAJE_DESCUENTO	Porcentaje de descuento.	17,4	Si no aplica, debe ir con valor 0.
NOTA	Observaciones.	200	Texto libre para adicionar a los registros descripciones.

Ejemplo

{
  "CLAVE": "Set_Gestion_Primario_S",
  "TIPO": "FEVS1",
  "PREFIJO": "API",
  "NUMERO": "55",
  "FECHA": "10.04.2025",
  "VENCE": "10.04.2025",
  "ANTICIPO": 0,
  "TERCERO": "16075913",
  "VENDEDOR": "PV",
  "LISTA": "NA",
  "BANCO": "ADMI",
  "USUARIO": "SUPERVISOR",
  "NOTA": "-",
  "RESUMEN": "",
  "CONTRATO": "06",
  "POLIZA": "",
  "DETALLE": "C1,BG,41104990,0,1,5000,0,NOTA1",
  "BLOQUEADO": "S",
  "ENVIADO": "S"
}

Respuesta

Exitosa

{
  "cod_error": 0,
  "execsql": 0
}

Fallida

{
  "cod_error": 0,
  "ex_execsql": "[FireDAC][Phys][FB]exception 10\r\nREST_ERROR\r\n*** EL RESUMEN 10 NO EXISTE ***\r\nAt procedure 'REST_INSERT_GESTION_PRIMARIO_S' line: 99, col: 43"
},
{
    "cod_error": 0,
    "ex_execsql": "[FireDAC][Phys][FB]exception 10\r\nREST_ERROR\r\n*** EL TERCERO 80013090 NO EXISTE ***\r\nAt procedure 'REST_INSERT_RESUMEN' line: 21, col: 39"
},
{
    "cod_error": 0,
    "ex_execsql": "[FireDAC][Phys][FB]exception 10\r\nREST_ERROR\r\n*** EL USUARIO SUPERVI NO EXISTE ***\r\nAt procedure 'REST_INSERT_RESUMEN' line: 27, col: 39"
},
{
    "cod_error": 0,
    "ex_execsql": "[FireDAC][Phys][FB]exception 10\r\nREST_ERROR\r\n*** EL CONTRATO 99 NO EXISTE ***\r\nAt procedure 'REST_INSERT_GESTION_PRIMARIO_S' line: 131, col: 47"
},
{
    "cod_error": 0,
    "ex_execsql": "[FireDAC][Phys][FB]exception 10\r\nREST_ERROR\r\n*** LA REFERENCIA 4110499 NO EXISTE ***\r\nAt procedure 'REST_INSERT_GESTION_PRIMARIO_S' line: 212, col: 61"
}