/
Servicio Articulo

Servicio Articulo

Estado

<EN USO>

En Uso

Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso.


Descripción general y propósito del servicio

Situación actual

DescripciónPermite dar de alta artículos y calsificarlo para ser usado en un grado específico
Referencia/wiki/spaces/SSB/pages/51904547
Entidad BDCarticulo , articulo_materia, articulo_grado_periodo, articulo_nivel_precio
Backendhttps://homol.uno-internacional.com/ws/uno_wsx_articulo_grado_periodo_precio_im.php
Tipo de Petición

POST / PUT

Parámetros
Campos en PayloadDescripciónReglas de negocio
accion
  • i  para indicar que se crea una entidad, m para modificar una entidad 
  • Obligatorio
  • Cuando se desea crear una entidad el valor de articulo_id debe ser 0.
  • Cuando se desea modificar una entidad de articulo, el valor de articulo_id debe ser mayor que 0.
p
  • IP de la máquina desde la que se consume el servicio
  • Obligatorio


t
  • Token de sesión
  • Obligatorio
  • El token de sesión se obtiene mediante el servicio de login
  • Tiene una duración de 8 horas
servicio
  • Nombre del servicio, se deberá enviar articulo
  • Obligatorio
  • Nombre del servicio a utilizar de acuerdo a WSDL Import
articulo_id
  • Identificador único del artículo en BDC
  • Obligatorio
  • El ID del artículo debe ser mayor a 0, en el caso de crear una entidad de Artículo el valor enviado deberá ser 0.
erp_id
  • Identificador único del colegio en ERP (EMS, SAP, ETC)
  • Opcional

pais_id
  • Identificador del país al que pertenece el artículo
  • Obligatorio
empresa_id
  • ID de la empresa a la que pertenece el artículo
  • Obligatorio
articulo_clave
  • Identificador único del artículo o el equivalente al erp_id
  • Obligatorio
  • La clave es utilizada para localizar de forma rápida al Artículo en búsquedas
articulo
  • Nombre del articulo
  • Obligatorio
articulo_orden
  • Orden de listado en los filtros
  • Opcional
  • Número > 0
articulo_grado_periodos
  • Agrupador de articulo_grado_periodos
Esta agrupación definirá la configuiración que tendrá el artículo por ciclo, periodo, nivel y grado, si se desea esta configuración se puede realizar por colegio
articulo_grado_periodo
  • Agrupador de articulo_grado_periodo

articulo_grado_periodo_id
  • Identificador único de articulo_grado_periodo_id
  • Obligatorio
  • Cuando se desea crear una nueva agrupación el valor  deberá ser 0
  • Cuando se modifica una agrupación el valor deberá ser > 0
grado_id
  • Identificador del grado al que estará asociado el artículo
  • Opcional
grado_clave
  • Clave del grado al que estará asociado el artículo
  • Obligatorio
grado_erp
  • Erp del grado al que estará asociado el artículo
  • Opcional
nivel_clave
  • Clave del nivel al que estará asociado el artículo
  • Obligatorio
nivel_erp
  • Erp del nivel al que estará asociado el artículo
  • Opcional
ciclo_escolar_id
  • Identificador del ciclo al que está asociado el Ciclo escolar.
  • Opcional
ciclo_escolar_clave
  • Clave del ciclo escolar al que estará asociado el artículo
  • Obligatorio
periodo_ciclo_id
  • Identificador del periodo al que estará asociado el artículo, este periodo debe estar definido para el ciclo escolar indicado anteriormente.
  • Opcional
periodo_ciclo_clave
  • Clave del periodo al que estará asociado el artículo, este periodo debe estar definido para el ciclo escolar indicado anteriormente.
  • Obligatorio
periodo_ciclo_parametro
  • Parámetro del periodo al que estará asociado el artículo, este periodo debe estar definido para el ciclo escolar indicado anteriormente.
  • Opcional (este campo se debe enviar si los datos periodo_ciclo_id  y periodo_ciclo_clave no fueron enviados)
activo
  • Determinará si la configuración debe estar activa.
  • Posibles valores 1 / 0
colegio_id
  • Identificador del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio.
  • El ID del colegio debe ser mayor a 0, asignado automáticamente por BDC.
colegio_clave
  • Clave del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio.

colegio_erp_id
  • Código de ERP asignado en BDC del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio y no se cuenta con los datos id y clave

colegio_crm_id
  • Código de CRM asignado en BDC del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio y no se cuenta con los datos id , clave y erp_id

articulo_nivel_precios
  • Agrupador de articulo_nivel_precios
Esta agrupación permite asignar el precio e impuesto al articulo según el PVP.
articulo_nivel_precio
  • Agrupador de articulo_nivel_precio

articulo_nivel_precio_id
  • Identificador del articulo_nivel_precio_id al que estará asociado el artículo
  • Opcional
  • Cuando se desea crear una entidad el valor de articulo_nivel_precio_id debe ser 0.
  • Cuando se desea modificar una entidad la tabla articulo_nivel_precio, el valor de articulo_nivel_precio_id debe ser mayor que 0.
nivel_precio_id
  • Identificador del nivel_precio al que estará asociado el artículo
  • Opcional ( será obligatorio si no se envía el tag nivel_precio_clave)
nivel_precio_clave
  • Clave del nivel_precio al que estará asociado el artículo.
  • Obligatorio
colegio_nivel_ciclo_id
  • Identificador del colegio_nivel_ciclo_id al que estará asociado el artículo
  • Opcional
  • El id se envía si el precio a configurar sólo aplicará a un nivel_ciclo  configurado en la agrupación por colegio.
colegio_grado_grupo_id
  • Identificador del colegio_grado_grupo_id al que estará asociado el artículo
  • Opcional
  • El id se envía si el precio a configurar sólo aplicará a un grado_grupo configurado en la agrupación por colegio.
precio
  • Precio con el que se configura el artículo
  • Obligatorio
  • Valor permitido Float
impuesto_porcentaje
  • Porcentanje que será usado en caso de que el artículo maneje un impuesto
  • Opcional
  • Valor permitido Float
Ejemplo de llamada o de formulario
Payload
Payload
<xs:schema id="articulo_grado_periodo_precio_im"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
attributeFormDefault="unqualified"
elementFormDefault="qualified">
<xs:element name="articulo_grado_periodo_precio_im">
<xs:complexType>
<xs:sequence>
<xs:element name="Articulo">
<xs:complexType>
<xs:sequence>
<xs:element type="xs:integer" name="articulo_id" minOccurs="0"/>
<xs:element type="xs:integer" name="empresa_id"/>
<xs:element type="xs:integer" name="pais_id"/>
<xs:element type="xs:string" name="articulo_clave"/>
<xs:element type="xs:string" name="articulo"/>
<xs:element type="xs:string" name="articulo_abrev" minOccurs="0"/>
<xs:element type="xs:string" name="articulo_alterno" minOccurs="0"/>
<xs:element type="xs:string" name="articulo_orden"/>
<xs:element type="xs:string" name="erp_id" minOccurs="0"/>
<xs:element type="xs:string" name="ean" minOccurs="0"/>
<xs:element type="xs:string" name="isbn" minOccurs="0"/>
<xs:element type="xs:string" name="ean_alterno" minOccurs="0"/>
<xs:element type="xs:string" name="materia_clave" minOccurs="0"/>
<xs:element type="xs:string" name="categoria_parametro"/>
<xs:element type="xs:string" name="tipo_articulo_parametro"/>
<xs:element type="xs:string" name="agrupa_articulo_parametro" minOccurs="0"/>
<xs:element type="xs:string" name="parametro"/>
<xs:element name="articulo_grado_periodos">
<xs:complexType>
<xs:sequence>
<xs:element name="articulo_grado_periodo" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
						<xs:element type="xs:string" name="articulo_grado_periodo_id" minOccurs="0"/>
						<xs:element type="xs:integer" name="grado_id" minOccurs="0"/>
						<xs:element type="xs:string" name="grado_clave"/>
						<xs:element type="xs:string" name="grado_erp" minOccurs="0"/>
						<xs:element type="xs:string" name="nivel_clave"/>
						<xs:element type="xs:string" name="nivel_erp" minOccurs="0"/>
						<xs:element type="xs:integer" name="ciclo_escolar_id" minOccurs="0"/>
						<xs:element type="xs:string" name="ciclo_escolar_clave"/>
						<xs:element type="xs:integer" name="periodo_ciclo_id" minOccurs="0"/>
						<xs:element type="xs:string" name="periodo_ciclo_clave"/>
						<xs:element type="xs:string" name="periodo_ciclo_parametro" minOccurs="0"/>
						<xs:element type="xs:integer" name="activo"/>
						<xs:element type="xs:integer" name="colegio_id" minOccurs="0"/>
						<xs:element type="xs:string" name="colegio_clave" minOccurs="0"/>
						<xs:element type="xs:string" name="colegio_erp_id" minOccurs="0"/>
						<xs:element type="xs:string" name="colegio_crm_id" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="articulo_nivel_precios">
	<xs:complexType>
		<xs:sequence>
			<xs:element name="articulo_nivel_precio" minOccurs="0" maxOccurs="unbounded">
				<xs:complexType>
					<xs:sequence>
						<xs:element type="xs:integer" name="articulo_nivel_precio_id" minOccurs="0"/>
						<xs:element type="xs:integer" name="nivel_precio_id" minOccurs="0"/>
						<xs:element type="xs:string" name="nivel_precio_clave"/>
						<xs:element type="xs:integer" name="colegio_nivel_ciclo_id" minOccurs="0"/>
						<xs:element type="xs:integer" name="colegio_grado_grupo_id" minOccurs="0"/>
						<xs:element type="xs:decimal" name="precio"/>
						<xs:element type="xs:decimal" name="impuesto_porcentaje" minOccurs="0"/>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
		</xs:sequence>
	</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Respuesta
Respuesta
<?xml version="1.0" encoding="utf-8"?>
<articulo_im_resultado xmlns="http://www.sistemauno.com/source/xml">
  <OK>
    <articulo_id>27466</articulo_id>
    <erp_id>SE BEC E 9 F2 18</erp_id>
    <empresa_id>7</empresa_id>
    <ok_text>Transacción exitosa: m</ok_text>
  </OK>
</articulo_im_resultado>

Related content

Servicio Consulta Contratos: /source/ws/uno_wsx_contrato_consultar.php
Servicio Consulta Contratos: /source/ws/uno_wsx_contrato_consultar.php
More like this
Servicio IME Alumno: /source/ws/uno_ws_ime_alumno.php
Servicio IME Alumno: /source/ws/uno_ws_ime_alumno.php
More like this
Servicio Consulta Pagos
Servicio Consulta Pagos
More like this
consultarTransacao
consultarTransacao
More like this
Servicio Colegio
Servicio Colegio
More like this
Servicio Consultar Censo
Servicio Consultar Censo
More like this