Ventas > Crear documentos de venta DTE via API integracion externas

Crear Venta DTE

• URL: /ventasIntegracionExternas.create.json
• Método: POST
• Descripción: Este endpoint de la API permite generar o enviar a OBUMA ventas hechas en otros sistemas, para ser emitidas y enviadas al SII por OBUMA.
• Parámetros (JSON Body):

Permite enviar un array con el contenido del documento a procesar.

Sirve tanto para facturas, guias, notas de debito y credito, boletas y notas de venta. 

Ejemplo array php : 

$data = array(
   
    'venta_tipo_dcto'     => 33, // el codigo del tipo documento segun normas del SII
    'venta_nro_dcto'     => "", // irrelevante, obuma maneja el folio
    'venta_fecha'         => "2017-04-06",
    'venta_fecha_vencimiento'       => "2017-04-06",

    'venta_canal'     => '', // codigo creado en obuma   
    'venta_sucursal'     => '', // codigo creado en obuma
    'venta_bodega'         => '', // codigo creado en obuma
    'venta_lista_precio'=> '', // codigo creado en obuma
    'venta_usuario'     => '', // codigo creado en obuma
    'venta_vendedor'     => '', // codigo creado en obuma

    'venta_subtotal'     => 100,
    'venta_exento'         => 0,
    'venta_neto'         => 100, 
    'venta_iva'         => 19,
    'venta_total'         => 119,
    'venta_total_pagado'     => 0,
    'venta_total_por_pagar' => 0,

    'cliente_rut'             => "99.999.999-9", 
    'cliente_razon_social'     => "Cliente de Prueba SpA",
    'cliente_direccion'     => "Alameda 1000",
    'cliente_comuna'         => 46,
    'cliente_region'         => 13,
    'cliente_giro'             => "Servicios",
    'cliente_email'         => "",
    'cliente_telefono'         => "00000",
    'cliente_contacto'         => "Don Juan Perez",

    'venta_detalle' => array (

       'codigo_comercial'        => "", // codigo sku
       'producto_nombre'        => "Servicio mantencion",
       'mostrar_descripcion'    => "",
       'producto_descripcion'    => "Mantencion detallada",
       'cantidad'                => 1,  
       'producto_precio'        => 100,
       'descuento'                => 0,
       'descuento_monto'        => 0,
       'subtotal'                => 100,
       'producto_exento'        => "", // si el producto es exento indicar 1
       'unidad_medida'            => ""

    ),

   'venta_referencias' =>  array(

       'tipo_dcto_ref' => '801', 
       'folio_dcto_ref' => '1',
       'fecha_dcto_ref' => '2018-01-10',
       'codigo_ref' => 'codigo segun sii',
       'razon_ref' => 'breve detalle',

   ),
   'venta_extra_datos' =>  array(

     'key' =>test',
     'value' =>123'
  
  ),

                  
);


$data =  array('docs' => $data); 

Ejemplo estructura json:

{
  "docs": [
{
  "venta_tipo_dcto": 56,
  "venta_nro_dcto": "",
  "venta_fecha": "2020-01-25",
  "venta_fecha_vencimiento": "2020-01-25",
  "venta_sucursal": "S-VGH-01",
  "venta_bodega": "B-VGH-01",
  "venta_lista_precio": "L-VGH-01",
  "venta_usuario": "",
  "venta_vendedor": "V-VGH-01",
  "venta_subtotal": "0",
  "venta_exento": "2363358",
  "venta_neto": "0",
  "venta_iva": "0",
  "venta_total": "2363358",
  "venta_total_pagado": 0,
  "venta_total_por_pagar": 0,
  "cliente_rut": "7.743.110-0",
  "cliente_razon_social": "KIPREOS INGENIEROS S.A",
  "cliente_direccion": "AMERICO VESPUCIO",
  "cliente_comuna": "21",
  "cliente_giro": "-",
  "cliente_email": "-",
  "cliente_telefono": "4431301",
  "venta_condicion_pago": "-",
  "venta_observacion": "-",
  "venta_detalle": [
    {
      "identificador": "53c3bce66e43be4f209556518c2fcb54",
      "producto_nombre": "Reversa Nota Credito",
      "mostrar_descripcion": "",
      "producto_descripcion": "",
      "cantidad": "1",
      "producto_precio": "2363358",
      "descuento": "0",
      "descuento_monto": "0",
      "subtotal": "2363358",
      "codigo_comercial": "",
      "producto_exento": "1",
      "unidad_medida": "",
      "imagen": "",
      "type": "",
      "id": "292"
    }
   ]
}
  ]
}

OJOOO: docs es un array de dctos... 

Ejemplo de uso:

$url='https://api.obuma.cl/v1.0/ventasIntegracionExternas.create.json';
$json = post_recurso($url, $data); // funcion mostrada en el articulo de Introduccion a la API

Para revisar el resultado del envio puedes usar : print_r($json);

El resultado va a devolver varias variables, como:

$json['result']['result']  esta variable debe indicar OK

$json['result']['result_detail'] esta variable indica el log de la operacion

// En la variable result_dte obuma te devuelve el folio del DTE asignado por OBUMA, mas la url del PDF y del XML
$resultado = $json['result']['result_dte'];

foreach($resultado as $r){
        echo '
'.$r['dte_folio'].' '.$r['dte_result'].' '.$r['dte_id_obuma'].' '.$r['dte_pdf'];

}

Ejemplo resultado con errores:

{"errors":[{"code":111,"message":"Invalid Parameters: Error en id cliente."}]}
Se debe a RUT erroneo.

{"errors":[{"code":112,"message":"Invalid Parameters: Error no hay CAF."}]}
Se debe a que no hay FOLIOS disponibles.

Tener en cuenta que las sumatorias de los subtotales las hace usted via API.
OBUMA no hace calculos de los totales, los totales son informados en el JSON y se asume que ya vienen calculados.

En los items :
subtotal = ( ( cantidad * producto_precio ) - descuento_monto )






 

Otras opciones o variables :

Si quieres que obuma envie el email con el DTE al cliente automaticamente :

$venta_enviar_email_cliente=1;

Si quieres rebajar stock al vender :

$venta_rebajar_stock=1;

$venta_bodega=CODIGO BODEGA EN OBUMA

El producto debe existir en obuma y estar marcado como inventariable.

Si quieres informar las referencias del documento :

$venta_referencias = array();

"venta_referencias": [
{
"tipo_dcto_ref" : "801",
"folio_dcto_ref" : "30",
"fecha_dcto_ref" : "10-11-2018",
"codigo_ref" : "codigo segun sii",
"razon_ref" : "breve detalle"
}
]

Las notas de credito utilizan los mismos campos que una factura, solo se diferencian por el codigo del tipo dcto y por la referencia.

La referencia debe indicar los datos del dcto al que se aplica la nota de crédito.

Si quieres informar extra datos de libre uso :

$venta_extra_datos = array();

"venta_extra_datos": [
{
"key" : "external_id",
"value" : "30"
},

{
"key" : "external_site",
"value" : "www.obuma.cl"
}
]

Si quieres emitir una guia despacho :

Las guias de despacho utilizan los mismos campos que una factura, solo se diferencian por el codigo del tipo dcto, por los indicadores del tipo despacho y traslado, y por la referencia.

'venta_referencias' =>  array(

       'tipo_dcto_ref' => '33', 
       'folio_dcto_ref' => '100',
       'fecha_dcto_ref' => '2018-01-10',
       'codigo_ref' => '',
       'razon_ref' => 'despacho',

   ),

Si quieres manipular tú tus folios :

$venta_nro_dcto = {TuFolio};

$venta_nro_dcto_fijo = 1; // Esto hace que OBUMA respete el folio informado por ti en el campo $venta_nro_dcto

 Bajo esta modalidad, la responsabilidad de administrar la asignacion de los folios es del usuario.

Para hacer que OBUMA valide los documentos antes de procesarlos y evitar duplicidad de folios o documentos, utilizar los siguientes parametros:

$venta_external_id_validar = 1

$venta_external_id = {$id} // Indicar el id unico en tu sistema, para que OBUMA valide su existencia, si ya existe, no procesa el dcto enviado.

Codigos TIPOS DOCUMENTOS :

4 : Nota de venta

33 : Factura electronica

34 : Factura electronica exenta

56 : Nota de debito electronica

61 : Nota de credito electronica

52 : Guia de despacho electronica

39 : Boleta electronica

41 : Boleta electronica exenta