---
title: "Crear o editar un proveedor de domicilio"
method: POST
path: "/deliveryProviders"
tags: ["Proveedores de Domicilio"]
---

# Crear o editar un proveedor de domicilio

`POST /deliveryProviders`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/deliveryProviders`
- Auth: HTTP bearer

Crea un nuevo proveedor de domicilio o actualiza uno existente.
- Si se envía `_id` en el body, se **actualiza** el proveedor existente.
- Si no se envía `_id`, se **crea** un nuevo proveedor.
- Se puede adjuntar una imagen (campo `avatar`) como `multipart/form-data`.
- Requiere el permiso **DP_POST** (Crear/Editar).

## Request body `multipart/form-data`

- object
  - `_id` string: ID del proveedor. Si se envía, se actualiza; si no, se crea.
  - `name` string, required: Nombre del proveedor de domicilio
  - `urlImage` string: URL de la imagen del proveedor (se sobreescribe si se sube avatar)
  - `isActive` boolean: Si el proveedor está activo
  - `percentagePerSale` number: Porcentaje que cobra el proveedor por cada venta
  - `unpaidSalesForDefault` boolean: Si las facturas quedan pendientes por pagar por defecto
  - `paymentMethod` string: ID del método de pago asociado al proveedor
  - `avatar` string, binary: Imagen del proveedor (máximo 8MB)

## Response `200`

Proveedor de domicilio creado o actualizado exitosamente

- DeliveryProvider: Proveedor de domicilio (delivery)
  - `_id` string: ID único del proveedor de domicilio
  - `business` string: ID del negocio al que pertenece el proveedor
  - `name` string: Nombre del proveedor de domicilio
  - `urlImage` string: URL de la imagen/logo del proveedor
  - `isActive` boolean: Si el proveedor está activo
  - `percentagePerSale` number: Porcentaje que cobra el proveedor por cada venta
  - `unpaidSalesForDefault` boolean: Si las facturas quedan pendientes por pagar por defecto
  - `paymentMethod` object: Método de pago asociado al proveedor (populado)
    - `_id` string
    - `name` string
  - `deleted` boolean: Si el proveedor está eliminado (soft delete)
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `createdOn` string, date-time: Fecha de creación

## Other responses

- `500`: Error interno del servidor

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)