> ## 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.

# Registro de proveedor

El servicio permite registrar la inscripción de un proveedor desde el portal, en línea en formato JSON.

Si no existe un tercero de la empresa con el tipo y número de documento enviados, se crea el tercero con los datos enviados. Luego se registra el proveedor asociado al tercero en estado **inactivo**, pendiente de aprobación por la empresa, junto con los documentos adjuntos.

El método de solicitud es POST y no requiere autenticación.

## Prerequisitos

Antes de realizar el registro del proveedor, se debe contar con los siguientes datos:

* Código del ambiente de dominio de la empresa (AmbienteDominioID) obtenido del servicio de [ambiente de inicio de sesión](https://tech.sedierp.com/ambiente-de-inicio-de-sesion.md)
* Códigos de tipo de documento y tipo de persona obtenidos de los servicios de [tipos de documentos](https://tech.sedierp.com/tipos-de-documentos.md) y [tipos de personas](https://tech.sedierp.com/tipos-de-personas.md)
* Documentos del proveedor cargados previamente con el servicio de [carga de archivos](https://tech.sedierp.com/carga-de-archivos.md)
* Validación de existencia del tercero con el servicio de [validar existencia de proveedor](https://tech.sedierp.com/validacion-existencia-proveedor.md)

## Registrar proveedor

**Request URL:** [https://portal.sedierp.com/API/api/Proveedores/RegistrarTerceroProveedor](https://portal.sedierp.com/API/api/Proveedores/RegistrarTerceroProveedor)\
**Tipo:** POST \
**Content Type:** application/json

**AmbienteDominioID** `int` *required*

Código único del ambiente de dominio de la empresa (ID).

**TipoDocumentoID** `int` *required*

Código del tipo de documento de identificación del proveedor (ID).

**Documento** `string` *required*

Número de documento de identificación del proveedor, sin dígito de verificación (máx. 20 caracteres). El dígito de verificación se calcula automáticamente.

**TipoPersonaID** `int` *required*

Código del tipo de persona del proveedor (ID).

**Nombres** `string` *required*

Nombres o razón social del proveedor (máx. 250 caracteres).

**Apellidos** `string`

Apellidos del proveedor (máx. 250 caracteres).

**Direccion** `string`

Dirección del proveedor (máx. 200 caracteres).

**Telefono** `string`

Teléfono del proveedor (máx. 40 caracteres).

**Celular** `string`

Celular del proveedor (máx. 20 caracteres).

**Email** `string`

Correo electrónico del proveedor (máx. 400 caracteres).

**CiudadID** `int`

Código de la ciudad del proveedor (ID).

**TerceroID** `int`

Código único del tercero (ID). Actualmente no se utiliza: el tercero se identifica por el tipo y número de documento.

**DocumentosProveedores** `array`

Documentos adjuntos del proveedor (RUT, cámara de comercio, certificación bancaria, etc.).

**propiedades**

**Ruta** `string`

Ruta del archivo retornada por el servicio de [carga de archivos](https://tech.sedierp.com/extranet/cargar-archivos-upload) (máx. 200 caracteres).

```bash theme={null}
curl --location 'https://portal.sedierp.com/API/api/Proveedores/RegistrarTerceroProveedor' \
--header 'Content-Type: application/json' \
--data '{
	"AmbienteDominioID": 12,
	"TerceroID": null,
	"Nombres": "SUMINISTROS ANDINOS S.A.S.",
	"Apellidos": null,
	"Documento": "900123456",
	"Direccion": "CL 13 # 68 - 45 BG 3",
	"Telefono": "6014567890",
	"Celular": "3157894561",
	"Email": "facturacion@suministrosandinos.com",
	"TipoPersonaID": 2,
	"TipoDocumentoID": 6,
	"CiudadID": 11001,
	"DocumentosProveedores": [
		{ "Ruta": "3c9e1a7b-52d4-4e8f-a0b6-91d7f2c4e853RUT.pdf" },
		{ "Ruta": "8d2f4b61-07a9-4c3e-b5d8-2e6a9f1c7b04CamaraComercio.pdf" }
	]
}'
```

### Validaciones

* `AmbienteDominioID` es obligatorio. Si falta, el servicio responde HTTP 400 con el detalle de la validación.
* Los textos no deben superar la longitud máxima indicada en cada campo. Si la superan, el servicio responde HTTP 400 con el mensaje "El valor no puede superar N Caracteres".

> [!NOTE]
>
> Si el tercero ya existe en la empresa, no se actualizan sus datos: solo se registra el proveedor y sus documentos. El servicio no valida si el tercero ya está registrado como proveedor; use antes el servicio de [validar existencia de proveedor](https://tech.sedierp.com/validacion-existencia-proveedor.md).

### Respuesta

**TipoSalida** `string`

Resultado de la operación: "OK" o "Error".

**Codigo** `int`

Código de la operación: 200 cuando el registro es correcto.

**Descripcion** `string`

"Transacción Exitosa" cuando el registro es correcto.

Cuando ocurre un error, el servicio responde HTTP 400 con el detalle en `Message`.

```json Request theme={null}
{
  "AmbienteDominioID": 12,
  "TerceroID": null,
  "Nombres": "SUMINISTROS ANDINOS S.A.S.",
  "Apellidos": null,
  "Documento": "900123456",
  "Direccion": "CL 13 # 68 - 45 BG 3",
  "Telefono": "6014567890",
  "Celular": "3157894561",
  "Email": "facturacion@suministrosandinos.com",
  "TipoPersonaID": 2,
  "TipoDocumentoID": 6,
  "CiudadID": 11001,
  "DocumentosProveedores": [
    { "Ruta": "3c9e1a7b-52d4-4e8f-a0b6-91d7f2c4e853RUT.pdf" },
    { "Ruta": "8d2f4b61-07a9-4c3e-b5d8-2e6a9f1c7b04CamaraComercio.pdf" }
  ]
}
```

```json Exitosa theme={null}
{
    "total": 1,
    "rows": [
        {
            "TipoSalida": "OK",
            "Codigo": 200,
            "Descripcion": "Transacción Exitosa"
        }
    ],
    "result": 1
}
```

```json Error theme={null}
{
    "Message": "Error en el ambiente de dominio."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.